Skip to main content
POST /v1/data/medium/posts/run Pricing: $0.002 per post ($2.00 per 1,000).

Ways to call it

  • Keyword search: set queries (optional: language, minClaps, publishedAfter, publishedBefore, maxResults)
  • By tag: set tags (optional: tagSort, language, minClaps, publishedAfter, publishedBefore, maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Medium topic tags: the labels writers put on their posts, which are open-ended, so any tag that exists on Medium works. A tag is the part after medium.com/tag/, for example artificial-intelligence or startup. You can also type the words (‘Data Science’) or paste the tag link (medium.com/tag/data-science); both become the tag. Popular tags: artificial-intelligence, programming, startup, marketing, data-science, productivity, crypto, design. A tag that does not exist on Medium returns an error; use Keyword search for free words.
string[]
Words to search Medium posts for, like a search box, for example retrieval augmented generation or remote work. One request reads them all.
string
default:"newest"
Which list of the tag’s posts to read, for example newest or top-month. Newest first by default, the only order that reaches the whole archive; the top and trending lists hold about 100 posts each.Allowed values: newest (Newest first (whole archive)), trending (Trending now (about 100 posts)), top-week (Top this week (about 100 posts)), top-month (Top this month (about 100 posts)), top-year (Top this year (about 100 posts)), top-all-time (Top of all time (about 100 posts)), all-top (Best of every top list (about 400 posts)).
string
Only posts published on or after this date, for example 2025-01-01, or a relative time such as 30 days or 6 months.
string
Only posts published on or before this date, for example 2025-06-30, or a relative time such as 7 days.
integer
default:"0"
Only posts with at least this many claps (Medium’s likes), for example 100. 0 by default, which keeps every post.Min 0; max 100000000.
string
Only posts in this language, as a two-letter code, for example en or es. Leave empty for all languages.
integer
default:"100"
How many posts to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one post, keyed by these fields.

Example response

Abridged: long text and lists are shortened.