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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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.
Words to search Medium posts for, like a search box, for example retrieval augmented generation or remote work. One request reads them all.
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)).Only posts published on or after this date, for example 2025-01-01, or a relative time such as 30 days or 6 months.
Only posts published on or before this date, for example 2025-06-30, or a relative time such as 7 days.
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.Only posts in this language, as a two-letter code, for example en or es. Leave empty for all languages.
Example
Response fields
Each row indata is one post, keyed by these fields.