Medium APIComing soon

Medium Scraper API for Articles, Profiles and Publications

Read public articles, writer profiles, connections, publication archives and reading lists. Search articles, writers, publications and lists by keyword, browse tagged articles and collect responses with published content and engagement.

Create a free account. No credit card needed.

WHAT YOU CAN BUILD / 12 ENDPOINTS

Put Medium data to work.

Find your use case, then explore the request and response.

Get a Medium profile

GET/v1/medium/profile

Build a writer research directory from public names, bios, avatars, follower and following counts, post counts and linked social accounts.

List a Medium writer’s stories

GET/v1/medium/profile/posts

Build a writer reading list from article titles, authors, publication times, tags and engagement. Pass the returned cursor to retrieve another page.

Get a Medium publication

GET/v1/medium/publication

Build a publication research directory from names, descriptions, subscriber counts, images, tags, social accounts and public staff profiles with editor roles.

List a Medium publication’s stories

GET/v1/medium/publication/posts

Build a publication reading list from article titles, authors, publication times, tags and engagement. Continue with the returned cursor.

Get a Medium story

GET/v1/medium/post

Build an article research record with its title, subtitle, published paragraphs, text, author, publication, language, tags, reading time, word count, claps and response count.

List a Medium story’s responses

GET/v1/medium/post/responses

Build an article discussion index from response records, author details, publication times and parent IDs. Open a selected response URL with Post Details to retrieve its published content.

List Medium stories by topic

GET/v1/medium/tag/posts

Build a topic reading list from tagged articles with published content, author details, publication times and source links.

Search Medium

GET/v1/medium/search

Build a keyword discovery tool for posts, profiles, publications or lists. Compare article titles and engagement, writer names and bios, publication descriptions and subscriber counts, or list names, article counts and creators. Continue with the returned page number.

Get Medium followers

GET/v1/medium/profile/followers

Build a public audience directory from follower names, handles, bios, avatars and profile counts. Pass the returned cursor to continue the account list.

Get Medium following

GET/v1/medium/profile/following

Build a writer discovery directory from the public accounts a writer follows, with names, handles, bios, avatars and profile counts. Continue with the returned cursor.

Show more endpoints (2)Show fewer endpoints

Get Medium profile lists

GET/v1/medium/profile/lists

Build a writer reading-list directory from list names, descriptions, article counts, list IDs and creator profiles. Pass the returned cursor to retrieve another page.

Get Medium list

GET/v1/medium/list

Build a curated reading view from a public list’s name, description, creator and ordered article entries, with titles, authors, tags and engagement. Continue with the returned cursor.

HOW IT WORKS

From API key to Medium data in four steps.

Review the request example and response fields below.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 12 Medium endpoints and add its input, such as a public handle.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Medium data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

SAMPLE REQUEST

Request example.

Inspect the Get a Medium profile request and its example response.

Medium API access is coming soon. Explore the parameters and response fields in the playground and reference.

Open this endpoint in the playground Request and response fields
CURL / Get a Medium profileComing soon
# ScrapeAtlas · use your customer API key
export BASE_URL="https://api.scrapeatlas.com"

curl --get "$BASE_URL/v1/medium/profile" \
  -H "x-api-key: $SCRAPEATLAS_API_KEY" \
  --data-urlencode "handle=Medium"
GET/v1/medium/profile

View the example response in the playground.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 successful requests

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Medium API

Frequently Asked Questions

Explore the API reference

Medium API and scraping

What public data can I retrieve with the Medium API?

Retrieve writer profiles, public connections, publication staff, posts and reading lists as structured JSON. Open an article or response URL to read its published content and engagement. Search articles, writers, publications or lists by keyword and browse tagged articles to discover writing around a topic.

Can I retrieve a Medium writer’s profile, connections and reading lists?

Pass a handle to Profile for the writer’s bio, avatar and audience counts. Profile Posts reads their articles; Followers and Following return public account records; Profile Lists returns their reading lists. Continue each collection with its cursor. Pass a list’s 12-character ID to List Details for its metadata and ordered article entries.

How do I scrape a Medium article by its URL?

Pass a Medium article URL to Post Details to retrieve its title, subtitle, published paragraphs and text, author, publication, tags and language. Reading time, word count, claps and response count help you organize an article research record with its original source.

Medium: publications, search and responses

Can I search Medium articles, writers, publications and reading lists?

Use Search with a query and choose type=posts, profiles, publications or lists. Results include article titles and engagement, writer profiles, publication descriptions and subscriber counts, or list names, article counts and creators. Continue with the returned page number. Tag Posts browses articles for a selected tag.

Can I retrieve a Medium publication and its article archive?

Use Publication with its slug to read descriptions, subscriber counts, images, tags, social links and public staff profiles with editor roles. Publication Posts returns article titles, authors, publication times and engagement; set the result limit and pass the returned cursor to continue your reading list.

Can I retrieve the responses to a Medium article?

Pass an article URL to Post Responses to collect response records with author details, publication times and parent IDs. Continue with the returned cursor for another page. Pass a selected response URL to Post Details to read its published paragraphs and text alongside the discussion index.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?