EveryData platform API
Medium API
The scope of this Medium API is Medium articles grouped by tag, author, or publication; its 3 actions, including `tag`, `user_posts`, `publication`, retain independent inputs and returned-object meanings.
In the Medium catalog, `tag` retrieves a selected tag feed, whereas `username` drives `user_posts` for posts from a known account; a shared identifier never merges their response fields.
- Endpoint
- POST /api/v1/social
- Capabilities
- 3
- Per 1,000
- $1.389
Available capabilities
Compare the Medium actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
tagTag Retrieve a public tag feed from Medium. Accepts these parameters: | tag | — | Sync delivery | Catalog values: defaultLimit=10, maxLimit=25. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform |
user_postsPosts by user Retrieve public posts from Medium. Accepts these parameters: | username | url | Sync delivery | Catalog values: defaultLimit=10, maxLimit=25. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform |
publicationPublication Retrieve public publication details from Medium. Accepts these parameters: | publication | url | Sync delivery | Catalog values: defaultLimit=10, maxLimit=25. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · title · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform |
What does each Medium action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Medium tag parameters mean?
Retrieve a public tag feed from Medium. Accepts these parameters: tag. Returns these fields: reading_time_minutes, publication_name, like_count, and author_username.
tagRequired- Specifies the Medium topic tag slug (such as machine-learning), which strips leading # symbols, converts text to lowercase, and replaces spaces with hyphens. It does not perform arbitrary full-text searches.Medium: Topic Content Feeds and Paywalled Article BoundariesMedium's official documentation separately lists content feed URLs for authors, publications, and Topics, and explicitly notes that full articles behind a paywall are not included in RSS feeds. This reference clarifies object types and visible content without expanding into arbitrary full-text search or paywalled full-text retrieval.Checked
What do the Medium user_posts parameters mean?
Retrieve public posts from Medium. Accepts these parameters: username and url. Returns these fields: posted_at, is_members_only, text, and author_url.
usernameRequired- Specifies a Medium author handle or full author profile URL, formatting standalone handles into https://medium.com/@<handle> to fetch the author's published post list rather than profile metadata.Medium: Claps Do Not Represent Unique Reader CountsMedium allows a single reader to clap multiple times for an article, meaning the total clap count cannot be treated as unique reader volume. This interface does not provide author-visible per-person clap breakdowns, nor does the presence of the field guarantee that clap counts will always be returned.Checked
urlOptional- Provides a compatibility input for full author or publication URLs in user_posts and publication; required username or publication parameters must still be supplied. Returned post lists may include restricted posts without granting access to paywalled full text.
What do the Medium publication parameters mean?
Retrieve public publication details from Medium. Accepts these parameters: url and publication. Returns these fields: title, text, like_count, and is_members_only.
publicationRequired- Specifies a Medium publication slug or full publication URL rather than an article title or author handle, expanding standalone slugs into medium.com/<publication>.Medium: Publications and Author Pages Use Distinct Content FeedsMedium separates Publications from @username author pages, and specifies distinct content feed formats for publications on custom domains. This citation highlights object differences; inputs for this interface still follow the parameter specified above without requiring users to pass feed URLs, and no guarantee is made that all custom domains are verified.Checked
urlOptional- Provides a compatibility input for full author or publication URLs in user_posts and publication; required username or publication parameters must still be supplied. Returned post lists may include restricted posts without granting access to paywalled full text.
How to use the Medium API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"medium","action":"tag","params":{"tag":"<tag>"}}'
Medium API questions
What can I retrieve with the Medium API?
Set platform to medium. The current catalog lists tag, posts by user, and publication. These action names identify different Medium objects or views; they are not interchangeable search modes.
Which input starts a Medium `tag` request?
Specifies the Medium topic tag slug (such as machine-learning), which strips leading # symbols, converts text to lowercase, and replaces spaces with hyphens. It does not perform arbitrary full-text searches. Send it as tag inside params.
Which fields can Medium `tag` return?
Its declared schema includes title, text, author_name, and author_username. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Medium action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.