# Medium Articles Scraper: Tags, Authors, Publications & Claps (`getascraper/medium-articles-scraper`) Actor

Collect Medium articles by tag, author or publication with claps, responses, reading time, word count, language and author data. Go beyond the latest 10 stories, filter by date, claps and keywords, export full text as Markdown, and monitor for new articles on a schedule. No login needed.

- **URL**: https://apify.com/getascraper/medium-articles-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Social media, News, SEO tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.35 / 1,000 articles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 📝 Medium Articles Scraper: Tags, Authors, Publications & Claps

<table width="100%" style="margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#EAF6E9;border:1px solid #C3E3C1;border-top:4px solid #1A8917;border-radius:12px">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Every Medium story on a topic, with the claps to prove which ones worked</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Pull articles by tag, author or publication with claps, responses, reading time, word count and full text. Go back days or years, not just the latest 10. No Medium login needed.</span>
</td>
</tr>
</table>
<table width="100%" style="margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3E3C1;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1A8917">📈 Know what performs</span><br>
<span style="font-size:12px;color:#57534E">Claps, responses and reading time on every row, so you can rank by results.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3E3C1;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1A8917">🗂️ Go past the latest 10</span><br>
<span style="font-size:12px;color:#57534E">Read a tag day by day and walk the full history of any author or publication.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3E3C1;border-left:none;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1A8917">📄 Full text, ready for AI</span><br>
<span style="font-size:12px;color:#57534E">Article bodies as Markdown, plain text or HTML, with links and images listed.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C3E3C1;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:15px;font-weight:800;color:#1A8917">🔔 Only what is new</span><br>
<span style="font-size:12px;color:#57534E">Schedule a run and get just the stories you have not seen yet.</span>
</td>
</tr>
</table>

Need Medium articles in a spreadsheet instead of a browser tab? Give the actor a tag, a writer or a publication and it returns one clean row per story: title, link, publish date, claps, responses, reading time, tags, author and publication. Filter by date, popularity, language and keywords, switch on full text, and schedule it to catch new stories every day.

### 🔍 What does this actor do?

It reads the public pages of Medium and turns them into structured data. You can start from a topic tag, a Medium username, a publication, or a list of article links, and you can mix them in one run. Pasting any Medium link into the start URLs field also works, and the actor works out what kind of page it is.

For a tag, the actor reads the stories day by day, newest day first, so you can collect a week, a month or a year of a topic. For an author or a publication, it walks the whole publishing history from the newest story backwards. You are not limited to the handful of latest posts.

Every row carries the numbers content teams look for: claps, responses, reading time and word count. It also has the detected language, the tags, whether the story is member-only, the cover image, the author and the publication it appeared in.

Results download as JSON, CSV, Excel or XML, and rows appear in the dataset while the run is still going.

### 💡 Who uses this?

- **I run content marketing.** I scan the tags my customers read, keep only stories with 500+ claps from the last 90 days, and use the winners to plan what to write next.
- **I do SEO and outreach.** I list every publication that covers my topic and the writers who get responses, so I know who to pitch and where to guest post.
- **I build AI datasets.** I export thousands of articles as Markdown with the language and tags attached, ready to clean and feed into a training or search pipeline.
- **I track a market.** I schedule a daily run on a handful of tags and get only the new stories in a sheet, so I spot trends and competitors early.

### 🚀 How to use

<table width="100%">
<tr>
<td style="padding:16px 14px;width:33%;background:#EAF6E9;border:1px solid #C3E3C1;border-radius:10px 0 0 10px;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1A8917;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Pick your sources</span><br>
<span style="font-size:12px;color:#57534E">Add tags, authors, publications or article links, one per row.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF6E9;border:1px solid #C3E3C1;border-left:none;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1A8917;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Narrow it down</span><br>
<span style="font-size:12px;color:#57534E">Set a date range, minimum claps, language, keywords and how many articles you want.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF6E9;border:1px solid #C3E3C1;border-left:none;border-radius:0 10px 10px 0;vertical-align:top">
<span style="font-size:12px;font-weight:800;color:#1A8917;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Download or schedule</span><br>
<span style="font-size:12px;color:#57534E">Export the table, or schedule the run with monitor mode for fresh stories only.</span>
</td>
</tr>
</table>

### 📥 Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `tags` | array of strings | No | Medium tags to collect from, one per row, for example `machine-learning` or `startup`. Capital letters and spaces are fixed for you. A sample tag is prefilled and is ignored when you add other sources. |
| `authors` | array of strings | No | Medium usernames or profile links, for example `@dhh`. The whole publishing history of each author is read, newest first. |
| `publications` | array of strings | No | Publication names from the link (for example `better-programming`) or custom domains. The full story list of each publication is read, newest first. |
| `articleUrls` | array of strings | No | Direct links to single stories. Each one is read in full, with claps, responses, reading time, author and publication. |
| `startUrls` | array of URLs | No | Paste any Medium link and the type is detected: a tag page, a profile, a publication, an article or a short feed link. A feed link returns about the 10 newest stories with fewer details. |
| `dateFrom` | date | No | Keep articles published on or after this date. Accepts a calendar date or a relative value such as `7 days`. For tags it also limits how many days are read. |
| `dateTo` | date | No | Keep articles published on or before this date. Leave empty for up to now. |
| `minClaps` | integer | No | Skip articles with fewer claps. Claps are Medium's like count. 0 keeps everything. |
| `minResponses` | integer | No | Skip articles with fewer reader responses. 0 keeps everything. |
| `minReadingTimeMinutes` | integer | No | Skip short reads. 0 keeps everything. |
| `maxReadingTimeMinutes` | integer | No | Skip long reads. 0 means no upper limit. |
| `minWordCount` | integer | No | Skip articles shorter than this many words. |
| `paywall` | enum | No | Keep all stories, only freely readable ones, or only member-only ones. Member-only stories are never unlocked. |
| `languages` | array of strings | No | Keep only articles in these language codes, for example `en` or `es`. Empty means every language. |
| `includeKeywords` | array of strings | No | Keep articles whose title, subtitle, excerpt or tags contain at least one of these words. With full text on, the article body is searched too. |
| `excludeKeywords` | array of strings | No | Drop articles whose title, subtitle, excerpt or tags contain any of these words. |
| `requiredTags` | array of strings | No | Keep only articles that carry all of these tags. Scan a broad tag and require a narrower one. |
| `onlyPublications` | array of strings | No | Keep only articles from these publications. Handy when scanning a broad tag for a few outlets. |
| `onlyAuthors` | array of strings | No | Keep only articles from these writers. Handy when scanning a broad tag for known authors. |
| `excludeResponses` | boolean | No | Medium stores reader responses as small stories. On by default, so you receive real articles only. |
| `includeContent` | boolean | No | Adds the complete article body and exact claps and responses. Slower, because every article is opened. Off by default. |
| `contentFormat` | enum | No | Format of the body when full text is on: Markdown, plain text or HTML. Markdown is the default. |
| `includeLinksAndImages` | boolean | No | Adds the list of links and image addresses found in each article. Opens every article. Off by default. |
| `includeAuthorDetails` | boolean | No | Adds follower count and bio for each author. Author sources and full-text runs already include them. Off by default. |
| `onlyNewArticles` | boolean | No | Monitor mode. Returns only articles that earlier runs have not delivered, so a daily schedule gives a clean feed of new stories. |
| `monitorScope` | string | No | A name for one watch list. Use one name per schedule so two monitors do not share what they have already delivered. Defaults to `default`. |
| `maxItems` | integer | No | Total articles to return across all sources. Defaults to 10. |
| `maxItemsPerSource` | integer | No | Optional cap for each tag, author or publication. Empty splits the total evenly between your sources. |
| `sortBy` | enum | No | Newest first, most claps or most responses. The two ranked options read the full scan window first, then return the best articles. |
| `maxDaysToScan` | integer | No | How many days to read per tag, newest first. Defaults to 14, up to 366. Raise it for long date ranges. |
| `maxConcurrency` | integer | No | How many pages are read at once, from 1 to 8. Defaults to 3. |
| `proxyConfiguration` | object | No | Connection settings. The default works well. |

### 📊 Data table

Fields that Medium does not show for a story are left out of the row. Nothing is filled in with a placeholder.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Medium story ID. |
| `url` | string | Link to the article. |
| `title` | string | Article title. |
| `subtitle` | string | Subtitle, when the story has one. |
| `excerpt` | string | Short preview text. |
| `publishedAt` | string | Publish date and time. |
| `updatedAt` | string | Last update date and time. |
| `clapCount` | integer | Number of claps. |
| `responseCount` | integer | Number of reader responses. |
| `readingTimeMinutes` | number | Estimated reading time in minutes. |
| `wordCount` | integer | Number of words. |
| `language` | string | Detected language code. |
| `isMemberOnly` | boolean | True for member-only stories. |
| `tags` | array of strings | Tags the author gave the story. |
| `authorName` | string | Author display name. |
| `authorUsername` | string | Author username. |
| `authorUrl` | string | Link to the author profile. |
| `authorBio` | string | Author bio. |
| `authorImageUrl` | string | Author profile photo. |
| `authorFollowerCount` | integer | Author followers, when author details are collected. |
| `authorIsMediumMember` | boolean | True when the author is a Medium member. |
| `publicationName` | string | Publication the story appeared in, if any. |
| `publicationSlug` | string | Short name of the publication. |
| `publicationUrl` | string | Link to the publication. |
| `publicationDescription` | string | Publication description. |
| `publicationFollowerCount` | integer | Publication followers. |
| `imageUrl` | string | Cover image. |
| `content` | string | Article body, when full text is on. |
| `contentFormat` | string | Format of the body: markdown, text or html. |
| `contentIsPreview` | boolean | True when only the public preview of a member-only story could be read. |
| `images` | array of strings | Image addresses in the article, when links and images are on. |
| `links` | array of strings | Links in the article, when links and images are on. |
| `source` | string | The tag, author, publication or link that produced the row. |
| `sourceType` | string | tag, author, publication, article or feed. |
| `scrapedAt` | string | When the row was collected. |

#### Example output

One row from a run on the `startup` tag.

```json
{
    "id": "07a3439510ea",
    "url": "https://medium.com/the-ai-brief/the-ai-price-war-keeps-proving-me-right-07a3439510ea",
    "title": "The AI Price War Keeps Proving Me Right",
    "subtitle": "Epoch AI found AI became 13× cheaper per year at the same performance. Was I right about local AI?",
    "publishedAt": "2026-10-24T21:09:08.731Z",
    "updatedAt": "2026-10-24T21:09:08.731Z",
    "clapCount": 0,
    "responseCount": 0,
    "readingTimeMinutes": 10.4,
    "wordCount": 2499,
    "language": "en",
    "isMemberOnly": true,
    "tags": ["artificial-intelligence", "programming", "technology", "startup", "machine-learning"],
    "authorName": "Caspar - AI Engineer",
    "authorUsername": "CasparAI",
    "authorUrl": "https://medium.com/@CasparAI",
    "authorIsMediumMember": true,
    "publicationName": "The AI Brief",
    "publicationSlug": "the-ai-brief",
    "publicationUrl": "https://medium.com/the-ai-brief",
    "publicationFollowerCount": 196,
    "imageUrl": "https://miro.medium.com/v2/resize:fit:1400/1*2FbVknyOW6DDCEAgcbknlQ.jpeg",
    "source": "tag:startup",
    "sourceType": "tag",
    "scrapedAt": "2026-10-25T00:00:28.428Z"
}
```

### 💰 Pricing

Pricing is pay per result. You are charged for each article row saved to your dataset, and every field on the row is included in that price. Runs that find nothing cost nothing. There are no monthly subscriptions or minimum commitments, and the maximum charge you set for a run is always respected: the actor stops collecting once that limit is reached.

Free plan runs are limited to 25 articles per run, 3 runs per day, and a short wait between runs.

### ⭐ Enjoying Medium Articles Scraper?

<table width="100%" style="display:table;width:100%">
<tr>
<td style="padding:20px 24px 14px;background:#EAF6E9;border:1px solid #C3E3C1;border-left:5px solid #1A8917;border-radius:10px 10px 0 0">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">A whole topic on Medium just became a sorted table of stories, claps and writers.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other content and SEO teams find this actor. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#1A8917;border:1px solid #C3E3C1;border-top:none;border-radius:0 0 10px 10px;text-align:center">
<a href="https://apify.com/getascraper/medium-articles-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### ✨ Tips

- **Start small, then scale.** The default run returns 10 stories in seconds. Raise `maxItems` once the rows look right.
- **Find the winners.** Set `sortBy` to most claps and `dateFrom` to `30 days`. The actor reads the whole window first, then returns the top stories.
- **Match a narrow topic.** Scan a broad tag such as `programming` and set `requiredTags` to the narrow topic you care about.
- **Build a daily feed.** Turn on `onlyNewArticles`, give the schedule its own `monitorScope` and run it every morning.
- **Feed an AI pipeline.** Switch on full text with the Markdown format, then filter by `languages` and `minWordCount` to keep long, clean articles.
- **Keep an eye on member-only stories.** Use `paywall` set to free only if you need complete bodies, because member-only stories give a preview.

### ❓ FAQ

##### Do I need a Medium account or API key?

No. The actor never asks for a login, token or cookie. You only provide tags, usernames, publications or links.

##### Can it read member-only stories?

The title, author, claps, responses, reading time and word count are available for member-only stories. The full body is not, because it needs a Medium membership. With full text on you get the public preview and the row is flagged with `contentIsPreview`. Use the `paywall` filter to keep only free stories when you need complete text.

##### How far back can I go?

For authors and publications, the whole publishing history. For tags, each day is read separately, so set `dateFrom` and `maxDaysToScan` to cover the period you want. Medium lists up to 200 stories per tag per day, so on a very busy tag a day is a sample of its most prominent stories rather than every post.

##### Can I search Medium by keyword?

Not directly. Use tags, authors and publications as sources and narrow the results with `includeKeywords`, `requiredTags` and the other filters.

##### How do I get only new stories each day?

Turn on `onlyNewArticles` and schedule the run. The actor remembers what it already delivered under your `monitorScope` name and returns only stories that appeared since.

##### How fast is it?

The default run of 10 stories finishes in seconds. Listing rows are quick. Full text is slower because every article is opened, so a run with it takes longer per story.

##### Is this affiliated with Medium?

No. This is an independent tool and is not affiliated with, endorsed by, or sponsored by Medium or A Medium Corporation. All trademarks mentioned belong to their respective owners. The actor reads only public pages.

### 🔗 Other actors

- [CryptoPanic News Scraper: No Login, No API Key, Monitor Ready](https://apify.com/getascraper/cryptopanic-news-scraper) ↗ - collects crypto news with a monitor mode for fresh posts.
- [ZeroHedge News Scraper: Full Text, Author, Category, Pub Date](https://apify.com/getascraper/zerohedge-news-scraper) ↗ - gathers ZeroHedge articles with full text, author and category.
- [Press Release Scraper for PR Newswire: Search, Tickers, Monitor](https://apify.com/getascraper/prnewswire-press-release-scraper) ↗ - searches PR Newswire releases by topic and company ticker.
- [Quora Questions Monitor: No Login Needed, Track Content Changes](https://apify.com/getascraper/quora-qna-change-monitor) ↗ - tracks Quora questions and answers and flags what changed.
- [HN Who is Hiring Scraper](https://apify.com/getascraper/hn-hiring-scraper) ↗ - turns Hacker News hiring threads into a searchable job list.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/medium-articles-scraper/changelog.md

# Actor input Schema

## `tags` (type: `array`):

Medium tags to collect stories from, one per row, for example "machine-learning" or "startup". Every day page Medium lists for the tag is read, so you get far more than the 10 newest stories a feed shows. Spaces and capital letters are fixed for you.

## `authors` (type: `array`):

Medium usernames or profile URLs, one per row, for example "@dhh" or "https://medium.com/@dhh". Walks the whole publishing history of each author, newest first, not only the latest 10 stories.

## `publications` (type: `array`):

Publication names from the URL (for example "better-programming") or custom domains (for example "netflixtechblog.com"), one per row. Walks the full story list of each publication, newest first.

## `articleUrls` (type: `array`):

Direct links to individual Medium stories. Each one is read in full, including claps, responses, reading time, author and publication details.

## `startUrls` (type: `array`):

Paste any Medium link and the type is detected for you: a tag page, an author profile, a publication, an article, or a feed URL. A feed URL is read like a feed reader would, which returns about the 10 newest stories.

## `dateFrom` (type: `string`):

Only keep articles published on or after this date. Use a calendar date or a relative value such as "7 days". For tags this also limits how many day pages are read.

## `dateTo` (type: `string`):

Only keep articles published on or before this date. Leave empty for "up to now".

## `minClaps` (type: `integer`):

Skip articles with fewer claps than this. Claps are Medium's like count and the best quick signal of how well a story performed. 0 keeps everything.

## `minResponses` (type: `integer`):

Skip articles with fewer reader responses (comments) than this. 0 keeps everything.

## `minReadingTimeMinutes` (type: `integer`):

Skip short reads. Useful to drop quick notes and keep in-depth articles. 0 keeps everything.

## `maxReadingTimeMinutes` (type: `integer`):

Skip long reads. 0 means no upper limit on reading time.

## `minWordCount` (type: `integer`):

Skip articles shorter than this many words. 0 keeps everything.

## `paywall` (type: `string`):

Medium marks some stories as member-only. Choose whether to keep everything, only freely readable stories, or only member-only ones. Member-only stories are never unlocked: with full text on you receive the public preview and it is flagged as a preview.

## `languages` (type: `array`):

Keep only articles detected in these language codes, for example "en" or "es". Leave empty for every language.

## `includeKeywords` (type: `array`):

Keep only articles whose title, subtitle, excerpt or tags contain at least one of these words or phrases (case-insensitive). With full text switched on the article body is searched too.

## `excludeKeywords` (type: `array`):

Drop articles whose title, subtitle, excerpt or tags contain any of these words or phrases (case-insensitive).

## `requiredTags` (type: `array`):

Keep only articles that carry all of these tags, for example scan the "machine-learning" tag but require "python" as well.

## `onlyPublications` (type: `array`):

Keep only articles published in one of these publications (name from the URL or custom domain). Handy when scanning a broad tag for a few outlets.

## `onlyAuthors` (type: `array`):

Keep only articles written by one of these usernames. Handy when scanning a broad tag for known writers.

## `excludeResponses` (type: `boolean`):

Medium stores reader responses (comments) as small stories of their own. Leave this on to receive real articles only.

## `includeContent` (type: `boolean`):

Opens every article to add the complete body in the chosen format, plus exact claps and responses. Slower than listing only, because each article is one extra page read.

## `contentFormat` (type: `string`):

Format of the article body when full text is switched on. Markdown keeps headings, lists, links and code blocks, which suits AI datasets and LLM pipelines.

## `includeLinksAndImages` (type: `boolean`):

Adds the list of outbound links and image URLs found in each article body. Opens every article, like the full text option.

## `includeAuthorDetails` (type: `boolean`):

Looks up each distinct author once and adds their follower count and bio. Author sources and full-text runs already include it.

## `onlyNewArticles` (type: `boolean`):

Monitor mode for schedules: remembers the articles earlier runs delivered and returns only new ones, so a daily schedule on a tag gives a clean feed of fresh stories. Tag scans also stop at the previous run date.

## `monitorScope` (type: `string`):

Name of the memory used by monitor mode. Use one name per schedule, so two monitors with different tags do not share what they have already delivered.

## `maxItems` (type: `integer`):

Total number of articles to return across all sources. Raise it for bigger exports.

## `maxItemsPerSource` (type: `integer`):

Optional cap for each tag, author or publication. Leave empty to split the total evenly between your sources.

## `sortBy` (type: `string`):

Newest first returns rows as soon as they are found. The other two read the full scan window of each source first, then return the best articles.

## `maxDaysToScan` (type: `integer`):

A tag is read one calendar day at a time, newest day first. This caps how many day pages are read per tag, so a run stays bounded. Raise it for long date ranges.

## `maxConcurrency` (type: `integer`):

How many pages are read at the same time. Higher is faster but more likely to be slowed down by Medium.

## `proxyConfiguration` (type: `object`):

Apify Proxy datacenter IPs work for this target, no residential proxy is needed.

## Actor input object example

```json
{
  "tags": [
    "machine-learning"
  ],
  "authors": [],
  "publications": [],
  "articleUrls": [],
  "startUrls": [],
  "minClaps": 0,
  "minResponses": 0,
  "minReadingTimeMinutes": 0,
  "maxReadingTimeMinutes": 0,
  "minWordCount": 0,
  "paywall": "all",
  "languages": [],
  "includeKeywords": [],
  "excludeKeywords": [],
  "requiredTags": [],
  "onlyPublications": [],
  "onlyAuthors": [],
  "excludeResponses": true,
  "includeContent": false,
  "contentFormat": "markdown",
  "includeLinksAndImages": false,
  "includeAuthorDetails": false,
  "onlyNewArticles": false,
  "monitorScope": "default",
  "maxItems": 10,
  "sortBy": "newest",
  "maxDaysToScan": 14,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tags": [
        "machine-learning"
    ],
    "authors": [],
    "publications": [],
    "articleUrls": [],
    "startUrls": [],
    "minClaps": 0,
    "minResponses": 0,
    "minReadingTimeMinutes": 0,
    "maxReadingTimeMinutes": 0,
    "minWordCount": 0,
    "paywall": "all",
    "languages": [],
    "includeKeywords": [],
    "excludeKeywords": [],
    "requiredTags": [],
    "onlyPublications": [],
    "onlyAuthors": [],
    "excludeResponses": true,
    "includeContent": false,
    "contentFormat": "markdown",
    "includeLinksAndImages": false,
    "includeAuthorDetails": false,
    "onlyNewArticles": false,
    "monitorScope": "default",
    "maxItems": 10,
    "sortBy": "newest",
    "maxDaysToScan": 14,
    "maxConcurrency": 3,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/medium-articles-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "tags": ["machine-learning"],
    "authors": [],
    "publications": [],
    "articleUrls": [],
    "startUrls": [],
    "minClaps": 0,
    "minResponses": 0,
    "minReadingTimeMinutes": 0,
    "maxReadingTimeMinutes": 0,
    "minWordCount": 0,
    "paywall": "all",
    "languages": [],
    "includeKeywords": [],
    "excludeKeywords": [],
    "requiredTags": [],
    "onlyPublications": [],
    "onlyAuthors": [],
    "excludeResponses": True,
    "includeContent": False,
    "contentFormat": "markdown",
    "includeLinksAndImages": False,
    "includeAuthorDetails": False,
    "onlyNewArticles": False,
    "monitorScope": "default",
    "maxItems": 10,
    "sortBy": "newest",
    "maxDaysToScan": 14,
    "maxConcurrency": 3,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/medium-articles-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tags": [
    "machine-learning"
  ],
  "authors": [],
  "publications": [],
  "articleUrls": [],
  "startUrls": [],
  "minClaps": 0,
  "minResponses": 0,
  "minReadingTimeMinutes": 0,
  "maxReadingTimeMinutes": 0,
  "minWordCount": 0,
  "paywall": "all",
  "languages": [],
  "includeKeywords": [],
  "excludeKeywords": [],
  "requiredTags": [],
  "onlyPublications": [],
  "onlyAuthors": [],
  "excludeResponses": true,
  "includeContent": false,
  "contentFormat": "markdown",
  "includeLinksAndImages": false,
  "includeAuthorDetails": false,
  "onlyNewArticles": false,
  "monitorScope": "default",
  "maxItems": 10,
  "sortBy": "newest",
  "maxDaysToScan": 14,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call getascraper/medium-articles-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/medium-articles-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/g3FkRGAFUtBsBrRcQ/builds/5JNVdAM8hBe1PQLer/openapi.json
