Medium API
Medium API helps you to quickly extract data from Medium's Website (https://medium.com). You can gather data related to users, publications, articles…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Medium API helps you to quickly extract data from Medium's Website (https://medium.com).
You can gather data related to users, publications, articles (including its textual content), latest posts & top writers within a topic/niche, etc…
Endpoints 32
Welcome
- GETGet Welcome
/Test Endpoint Returns the information about the Medium API
User
- GETGet User ID
/user/id_for/:usernameReturns the unique user_id for the given username. Note: You can find the username from the user's/author's profile page URL. username.medium.com… - GETGet User Info
/user/:user_idReturns user related information like *Full name, Bio, Followers count, Following count, Twitter username, Profile-image URL, User ID, etc...* It takes… - GETGet User's Articles
/user/:user_id/articlesReturns the list of articles (article_ids) written by the user. - GETGet User Followers
/user/:user_id/followers?count=10Returns the list of user_ids of the user's followers. Note: The length of this followers' list might be different from what you get in the "Get User Info"… - GETGet User Following
/user/:user_id/following?count=10Returns the list of user_ids of the user's followings. Note: Currently, this list does not contain the publication_ids of the publications that the user is… - GETGet User's Interests
/user/:user_id/interestsReturns a list of tags that the given user follows. - GETGet User's Lists
/user/:user_id/listsReturns an array of list_ids created by the user. Note: You can check whether the use has created lists or not beforehand. Check the has_list attribute in the… - GETGet User's Publications
/user/:user_id/publicationsReturns a list of publication_ids where the user is the editor and/or creator. - GETGet User's Top Articles
/user/:user_id/top_articlesReturns a list of article_ids of the top 10 articles on the user's profile, for a given user_id.
Publication
- GETGet Publication ID
/publication/id_for/:publication_slugReturns the unique publication_id for the given publication_slug. Note: You can find the publication_slug from the publication's homepage URL.… - GETGet Publication Info
/publication/:publication_idReturns the publication related information such as *Publication name, Tagline, Description, Tags, Followers Count, Twitter username, Instagram username,… - GETGet Publication Articles
/publication/:publication_id/articles?from=2023-01-31T13:10:00Returns the list of articles_ids, of the latest 25 articles, posted in that publication. - GETGet Publication Newsletter
/publication/:publication_id/newsletterReturns the newsletter related information such as *id, name, description, slug, creator_id, subscribers, image_url, etc …* Note: If you don't know the…
Article
- GETGet Article Info
/article/:article_idReturns the article related information such as *Title, Subtitle, Tags, Topics* (assigned by Medium), *Publication, Published date and time, Clap Count, Voter… - GETGet Article's Content
/article/:article_id/contentReturns the content of an article/story, for the corresponding article_id - GETGet Article Fans
/article/:article_id/fansReturns a list of user_ids of the people who clapped on the article (a.k.a voters). - GETGet Article's Markdown
/article/:article_id/markdownReturns the markdown of an article/story from Medium, for the corresponding article_id - GETGet Related Articles
/article/:article_id/relatedReturns a list of article_ids of the related posts. (Length = 5) Note: If the given article is self-published, related posts will belong to the same author,… - GETGet Article Responses
/article/:article_id/responsesReturns 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…
Misc
- GETGet Latest Posts
/latestposts/:topic_slugReturns a list of latest posts (article_ids) for a topic/niche (as classified by the Medium platform). Example of a topic/niche can be: * blockchain *… - GETGet Related Tags
/related_tags/:tagReturns a list of related_tags for the given tag. - GETGet Top Writers
/top_writer/:topic_slug?count=10Returns a list of top writers (user_ids) within a particular topic/niche (topic_slug). e.g. blockchain relationships artificial-intelligence, etc ... Note:… - GETGet Topfeeds
/topfeeds/:tag/:mode?after=10&count=20Returns a list of article_ids (length: 25) for the given tag and mode.
List
- GETGet List Info
/list/:list_idReturns the list-related information such as *id, name, author, description, thumbnail image url, creation datetime, last article inserted datetime, number of… - GETGet List Articles
/list/:list_id/articlesReturns an array of articles_ids present in the given Medium List. - GETGet List Responses
/list/:list_id/responsesReturns an array of response_ids of the comments (same as article_ids) on the given Medium List.
Search
- GETSearch Articles
/search/articles?query=:query?query=startupReturns the list of articles_ids for the given search query results. (Max Length = 1000) - GETSearch Lists
/search/lists?query=:query?query=artificial intelligenceReturns an array of list_ids for the given search query results. (Max Length = 1000) - GETSearch Publications
/search/publications?query=:query?query=mental healthReturns the list of publication_ids for the given search query results. (Max Length = 1000) - GETSearch Tags
/search/tags?query=:query?query=blockchainReturns a list of tags for the given search query results. (Max Length = 1000) - GETSearch Users
/search/users?query=:query?query=data engineerReturns a list of user_ids for the given search query results. (Max Length = 1000)
API details
- Base URL
https://medium2.p.rapidapi.com- Authentication
- An API key in the x-rapidapi-host header
An API key in the x-rapidapi-key header - Operations
- 32 operations on 32 pathsGET 32
- Main resources
- User 9Article 6Search 5Misc 4Publication 4List 3Welcome 1
- Response formats
application/json- Description format
- OpenAPI 3.0.2, API version
1.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the Medium API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Medium API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the x-rapidapi-host header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get Welcome” (GET /), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Medium API?
Medium API helps you to quickly extract data from Medium's Website (https://medium.com). You can gather data related to users, publications, articles… It is listed under Social and has 32 endpoints.
Who publishes the Medium API?
It is listed from Medium's public API description (an OpenAPI document), not published by Medium on Swastik Codes. Anyone who controls medium.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Medium API?
Requests go to https://medium2.p.rapidapi.com. Endpoint paths are added to this base URL.
How do I authenticate with the Medium API?
It accepts 2 methods: an API key in the x-rapidapi-host header; an API key in the x-rapidapi-key header.
How many endpoints does the Medium API have?
32 operations on 32 paths (32 GET). The largest groups are User, Article, Search, Misc.
Is forking the Medium API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.