InsightSocial

Medium scraper API

The InsightSocial Medium API has 6 endpoints, from 20 credits a call. A tag posts call costs 20 credits, about $0.02 on Pro, and your first 10 calls up to 100 credits each are free.

The Medium scraper API for the newest posts of an author, a publication or a tag, with the full article HTML where Medium serves it, and daily sitemaps of every post URL.

6 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/medium/tag/posts?tag=javascript" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "medium",
"endpoint": "/v1/medium/tag/posts",
"schema_version": "2",
"data": {
"tag": {
"slug": "javascript",
"title": "JavaScript on Medium",
"url": "https://medium.com/tag/javascript/latest"
},
"posts": [
{
"post_id": "3f1dafb8ee54",
"title": "Example: reading QR codes in the browser",
"url": "https://medium.com/@example_writer/example-reading-qr-codes-3f1dafb8ee54",
"author_name": "Example Writer",
"tags": [
"programming",
"javascript"
],
"published_at": "2026-11-07T04:35:02.000Z",
"snippet": "Use the camera and native detection to scan QR codes on the device.",
"image_url": "https://cdn.example.com/posts/qr.png"
}
]
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Medium data can you get?

Public Medium data only, in the same JSON envelope as every other platform. Every Medium endpoint is beta: inside data it returns Medium's own structure under our naming rules (snake_case keys, string ids, ISO times where Medium gives a timestamp), not the shared profile and post schema, and fields may change.

Authors and publications

An author's ten newest posts, with the full article HTML when it is available, and a publication's ten newest, by slug or its own domain, optionally by tag.

Tags

The ten newest posts carrying a tag, with snippets and the first image.

Sitemaps

Every post URL Medium lists for one UTC day with last-modified dates, the users, publications, tags and lists in a day's sitemap, and the sitemap files themselves.

What people build with the Medium API

  • Content monitoring

    Check the authors and publications in your space on a schedule and catch new posts the day they appear.

  • Topic research

    Read the newest posts under a tag to see what writers are covering, with snippets and images to sort by.

  • Archives and datasets

    Walk a day's sitemap for every post URL and its last-modified date, then fetch the authors you care about.

Medium API endpoints

All 6 Medium endpoints and their price in credits. Every one has a fixed price.

EndpointCreditsWhat it returns
/author/posts20List an author's ten newest Medium posts, with the full article HTML when the article body is available.
/discover20List the user, publication, tag, list, topic, removed-post or removed-user URLs in one day's Medium sitemap.
/posts20List the post URLs and last-modified dates in one UTC day's Medium sitemap, paged with a cursor.
/publication/posts20List a publication's ten newest Medium posts by Medium slug or its own domain, optionally filtered by tag.
/sitemap40List one page of the available Medium sitemap files of one kind, with the newest real file.
/tag/posts20List the ten newest Medium posts carrying a tag, with snippets and first image when available.

Parameters, response fields and examples for each endpoint are in the Medium API reference.

InsightSocial vs the official Medium API

Medium's documented API publishes posts to the authenticated user's own account. It has no endpoints for reading other authors' posts.

InsightSocial APIOfficial Medium API
Reading postsAuthor, publication and tag postsNot documented
PublishingNot offeredPosts to your own account
SetupSign in and copy a keyAn integration token for your account
Cost per call20 creditsNo per-call price; publishing only

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Medium API cost?

Medium calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 500 tag or author reads at 20 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Medium data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Medium API: frequently asked questions

Medium's documented API is for publishing to your own account; it has no endpoints for reading other people's posts. /v1/medium/author/posts, /v1/medium/publication/posts and /v1/medium/tag/posts read public posts with one key.