Medium
Unofficial Medium API helps developers get clean data from medium.com, quickly and reliably. You can easily fetch and integrate content from Medium into your applications. Access user profiles, articles, publications, lists, tags, and more with powerful, flexible endpoints. It can save you hundreds of hours of development time. Potential use cases: - You can use this Unofficial API to sync up…
735 subscribers
2.3/10 popularity
422 ms avg latency
19% success rate
42 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Medium endpoints
| Method | Endpoint | Description |
|---|---|---|
| Article | ||
| GET |
Get Article Info /article/{article_id} |
Returns article-related information such as - Title - Subtitle - Author (ID) - Tags - Topics (assigned by Medium) - Publication (ID) - Published date and time - Last Modified… |
| GET |
Get Article's Markdown /article/{article_id}/markdown |
Returns the **markdown** of an article/story from Medium, for the corresponding `article_id` |
| GET |
Get Article's HTML /article/{article_id}/html |
Returns the plain **HTML** of a Medium Article, for the given `article_id`. Note: This plain HTML output can be stylized as per your own custom branding. For the sample CSS,… |
| GET |
Get Article's Content /article/{article_id}/content |
Returns the content of a Medium Article in plain text, for the given `article_id`. Note: This does not include text inside the image captions and embeds. |
| GET |
Get Article Assets /article/{article_id}/assets |
Returns a list of URLs for the assets present in the Medium Article. These assets may include images, embedded YouTube videos, Github Gists, Hyperlinks (anchors), Links to other… |
| GET |
Get Article Responses /article/{article_id}/responses |
Returns a list of responses (`response_ids`, same as `article_ids`) for a given article (`article_id`) Note: To see the content of the response, use the "Get Article's Content"… |
| GET |
Get Article Fans /article/{article_id}/fans |
Returns a list of *user_ids* of the people who clapped on the article. |
| GET |
Get Recommended Articles /article/{article_id}/recommended |
Returns a list of 10 articles (`article_ids`) as recommended by the Medium, for the given article. |
| GET |
Get Related Articles /article/{article_id}/related |
Returns a list of the related articles (`article_ids`) for the given article (`article_id`). **Note:** The length of the returned list will be equal to 4. These related posts… |
| User | ||
| GET |
Get User ID /user/id_for/{username} |
Returns a unique ID (user_id: String) associated with the user/author's unique username. |
| GET |
Get User Info /user/{user_id} |
Returns user-related information such as their - Username - Full name - Bio - Tier (FREE, MEMBER or FRIEND) - Followers count - Following count - Publication Following count -… |
| GET |
Get User Articles /user/{user_id}/articles |
Returns a list of Articles (`article_ids`) written by a specified user, with a maximum of 250 `article_ids` per request. If the user has published over 250 articles, use the… |
| GET |
Get Top Articles By User /user/{user_id}/top_articles |
Returns a list of `article_ids` of the top 10 articles on the user's profile, for a given `user_id`. These top 10 articles are returned in the same order they are displayed on… |
| GET |
Get User Followers /user/{user_id}/followers |
Returns a list of followers (`user_ids`) for the given user. Use `count` query string parameter (optional) to limit the number of results. (count |
| GET |
Get User Following /user/{user_id}/following |
Returns a list of users (`user_ids`) that the specified user is following. - Returns up to 500 results per request. - To fetch additional results, use the "next" query parameter… |
| GET |
Get User Publication Following /user/{user_id}/publication_following |
Returns a list of publications (`publication_ids`) that the given user is following. |
| GET |
Get User Interests /user/{user_id}/interests |
Returns a list of tags that the given user follows. |
| GET |
Get User Lists /user/{user_id}/lists |
Returns an array of *list_ids* created by the user. |
| GET |
Get User Publications /user/{user_id}/publications |
Returns 2 lists of *publication_ids* where the given user is either an admin (creator/editor) or a contributing writer. |
| GET |
Get User Books /user/{user_id}/books |
Returns a list of all the books published by the user. It includes the book's title, description, co-authors, published date, cover image, and URL. |
| Publication | ||
| GET |
Get Publication ID /publication/id_for/{publication_slug} |
Return the `publication_id` for the given `publication_slug`. |
| GET |
Get Publication Info /publication/{publication_id} |
Returns the publication related information such as Publication name, Tagline, Description, Tags, Followers Count, Twitter username, Instagram username, Facebook Page name, etc… |
| GET |
Get Publication Articles /publication/{publication_id}/articles |
Returns the list of `articles_ids`, of the latest 25 articles, posted in that publication. Use the `from` query parameter to get the articles before that date and time. |
| GET |
Get Publication Newsletter /publication/{publication_id}/newsletter |
Returns information related to the associated newsletter for the given publication. This includes their subscriber's count, name, description, unique id, etc... |
| Misc | ||
| GET |
Get Top Feeds /topfeeds/{tag}/{mode} |
Returns a list of `article_ids` (length |
| GET |
Get Top Writers /top_writers/{topic_slug} |
Returns a list of top writers (*user_ids*) within a particular topic/niche (e.g. "blockchain", "relationships", "artificial-intelligence"). **Note**: You can use `count` query… |
| GET |
Get Latest Posts /latestposts/{topic_slug} |
Returns a list of latest "curated/distributed" posts (*article_ids*) for a topic/niche (as classified by the Medium platform). Example of a topic/niche can be: - "blockchain" -… |
| GET |
Get Tag Info /tag/{tag} |
Returns tag-related information. - Name - Followers Count - Number of stories - Number of writers - Number of latest stories - Number of latest writers |
| GET |
Get Related Tags /related_tags/{tag} |
Returns a list of related tags for any given tag. Example: For tag *blockchain*, it will return *'cryptocurrency', 'bitcoin', 'ethereum', 'crypto', 'ico', 'technology', 'defi',… |
| GET |
Get Root Tags /root_tags |
Returns a list of root tags (or top-level tags) from the Medium Platform. This is how Medium broadly categorizes articles. These tags have their own child tags that you can fetch… |
| GET |
Get Recommended Feed /recommended_feed/{tag} |
Returns a list of recommended articles (`article_ids`) for the given `tag`. This feed is similar to Topfeeds Trending Articles. Using the `page` query string parameter, you can… |
| GET |
Get Recommended Users /recommended_users/{tag} |
Returns a list of recommended users (who to follow) for the given tag. Max length = 250. |
| GET |
Get Archived Articles /archived_articles/{tag} |
Returns a list of archived articles (max length = 20) for the given tag. You can filter the results by adding optional parameters like `year` and `month`. Use the `next`… |
| Search | ||
| GET |
Search Users /search/users |
Returns a list of *user_ids* for the given search query results. (Max Length = 1000) |
| GET |
Search Articles /search/articles |
Returns the list of *articles_ids* for the given search query results. (Max Length = 1000) |
| GET |
Search Publications /search/publications |
Returns the list of *publication_ids* for the given search query results. (Max Length = 1000) |
| GET |
Search Tags /search/tags |
Returns a list of *tags* for the given search query results. (Max Length = 1000) |
| GET |
Search Lists /search/lists |
Returns an array of *list_ids* for the given search query results. (Max Length = 1000) |
| List | ||
| GET |
Get List Info /list/{list_id} |
Returns the list-related information such as Id, Name, Author, Description, Thumbnail Image URL, Creation Datetime, Last Modified Datetime, number of articles in the list, claps,… |
| GET |
Get List Articles /list/{list_id}/articles |
Returns an array of *articles_ids* present in the given List (Medium List). |
| GET |
Get List Responses /list/{list_id}/responses |
Returns an array of *response_ids* (same as *article_ids*) on the given Medium List. |
| Other endpoints | ||
| GET |
Get Welcome / |
**Test Endpoint** Returns the information about the Medium API |
Medium pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $10 / month | — |
|
| ULTRA Recommended | $30 / month | — |
|
| MEGA | $150 / month | 120 / minute |
|
