Hey guys! This is the "Getting Started" Guide for the , listed on the . Medium API (Unofficial Version) RapidAPI Platform This REST API , without any hassle. helps you to quickly extract data from Medium Dotcom https://www.youtube.com/watch?v=oc8TKG9EQfE&embedable=true Using our Unofficial Medium Dotcom API, you can get- 's - Info, Articles, Top Articles, Followers, Following, Interests, Lists, Publications User 's - Info, Responses, Content, Markdown, HTML, Fans, Related Articles Article 's - Info, Articles, Newsletter Publication Top Feeds, Latest Posts, Top Writers, Tag Info, Related Tags - Info, Articles, Responses List's - Articles, Publications, Users, Lists, Tags Search 💡 Checkout our for the details on each endpoint! swagger documentation Before getting started, you must first to authenticate your calls. You'll need to , along with the requests, to use the API smoothly. get your API Key pass it in the headers Header - x-rapidapi-key: [RAPIDAPI_KEY] Wondering how to subscribe to our API and get an API Key? Watch the following video – https://www.youtube.com/watch?v=-MM1C6mb-mc&embedable=true API's Base URL: https://medium2.p.rapidapi.com GET User ID Every Medium user has one unique hash ID associated with his/her account. Usually, we only deal with usernames that we choose while registering on the Medium Platform. You can find your username in the sub-domain of your profile page URL or at the end of it. Like - https:// username .medium.com https:// medium.com/@ username Once you get your username, like mine is you can use the following endpoint to get your . nishu-jain, user_id Endpoint - GET /user/id_for/{username} Usage - Once you have the , you can invoke other user-related endpoints using it. user_id https://gist.github.com/weeping-angel/ac33f3d869ea8a859052fbb98e988385?embedable=true GET User Info Once you've got the , you can use it to get user-related information such as - user_id Full name, Username, Bio, Followers and Following count, Twitter username, Profile-image, top writer status, etc ... Endpoint - GET /user/{user_id} If you don't have the , see the endpoint above. user_id GET User ID Usage - https://gist.github.com/weeping-angel/c26f5b68a01c5482f5a712e0a652fdd3?embedable=true GET User's Articles This endpoint returns a list of articles ( ) written by the Medium user. article_ids 💡 You can then use the endpoint to retrieve information, such as related to your desired article. GET Article Info title, subtitle, author, claps, voters, tags, topics, publication, etc..., Endpoint - GET /user/{user_id}/articles Usage - https://gist.github.com/weeping-angel/c0c133d64268a9ef2a4eb62e0408f474?embedable=true GET User's Top Articles This endpoint returns a list of of the top 10 posts/articles on the user's profile (usually in chronological order - most recent posts), for the given user ( ). aritcle_ids user_id 💡 You can then use the endpoint to retrieve information on individual articles. GET Article Info Endpoint - GET /user/{user_id}/top_aritcles Usage - https://gist.github.com/weeping-angel/c64fb4791441951deeaaac458672879b?embedable=true GET User's Following This endpoint returns a list of of the given user's following. user_ids You can fetch this list and use the endpoint to retrieve information related to the individual users. GET User Info Currently, this list does not contain the of the publications that the user is following. Note: publication_ids Query Parameters : - (Optional) : To limit the number of results. ( <= 1500) count count Endpoint - GET /user/{user_id}/following Usage — https://gist.github.com/weeping-angel/7f3d13b52205e5b48a0edba8a8677bfe?embedable=true GET User's Followers This endpoint returns a list of of the followers for the given user. user_ids The length of followers' list might be different from what you get in the Endpoint. It's because, this list doesn't include Medium Users who left the platform. Note: Get User Info If you really need the exact followers' count, use this endpoint to get the followers' list and take its length as the exact followers' count You can use the endpoint to retrieve information related to the individual users. GET User Info Query Parameters : - (Optional) : To limit the number of results. ( <= 1500) count count Endpoint - GET /user/{user_id}/followers Usage - https://gist.github.com/weeping-angel/66e7ee163f48e426dec93fbded420802?embedable=true GET User's Interests This endpoint returns a list of that the given user follows on Medium. tags All tags are lowercase hyphen-separated strings. Endpoint - GET /user/{user_id}/interests Usage — https://gist.github.com/weeping-angel/deb68d4ac20f29fae389bc78d2bab6a4?embedable=true GET User's Lists This endpoint returns an array of created by the user. list_ids You can use the endpoint to retrieve information on individual Medium Lists. GET List Info Endpoint - GET /user/{user_id}/lists Usage - https://gist.github.com/weeping-angel/42ae06edabb0fc32d8047356b88685ab?embedable=true GET User's Publications This endpoint returns a list of where the user is the editor and/or creator. publication_ids You can use the endpoint to retrieve information on individual publications. GET Publication Info Endpoint - GET /user/{user_id}/publications Usage - https://gist.github.com/weeping-angel/177663bcaf85d98d3504a6df8889714e?embedable=true GET Article Info This endpoint returns the article-related information such as (as assigned by Medium), Title, Subtitle, Author, Tags, Topics Publication, Published date and time, Clap Count, Voter Count, Word Count, Responses Count, Reading Time, Language, etc... For using this endpoint, you'll need an article's unique hash ID, called . article_id You can find the at the end of any Medium Story's URL. Like - article_id medium.com/towards-artificial-intelligence/.. 67fa62fc1971 nishu-jain.medium.com/the-neutrality-of-dea.. 20abb01e5c85 Endpoint - GET /article/{article_id} Usage - https://gist.github.com/weeping-angel/3946e149d9b99b00e16fca59845ea2d3?embedable=true GET Article's Content This endpoint returns the textual content of an article/story, for the corresponding . article_id You can get the from the URL, as shown above in the endpoint. article_id GET Article Info Endpoint - GET /article/{article_id}/content Usage - https://gist.github.com/weeping-angel/d64a3b2a09ad468abc517949379b1c0b?embedable=true GET Article's Markdown This endpoint returns the article content in the markdown format ( ), for the corresponding . .md article_id You can get the from the URL, as shown above in the endpoint. article_id GET Article Info Endpoint - GET /article/{article_id}/markdown Usage - https://gist.github.com/weeping-angel/a692fc43a7f8a85aa25e358baf0544d6?embedable=true GET Article's HTML This endpoint returns the article in plain HTML format ( ), for the corresponding . .html article_id You can get the from the URL, as shown above in the endpoint. article_id GET Article Info Query Parameter ( ):- Optional Set parameter to to get the full HTML page with head, body, title, and meta tags. If is set to or not provided, the endpoint will only return the HTML inside the body tag. fullpage true fullpage false Endpoint - GET /article/{article_id}/html GET /article/{article_id}/html?fullpage=true Usage - https://gist.github.com/weeping-angel/7a2ccc872b043fd0113fe418515a8631?embedable=true GET Article's Responses This endpoint returns a list of responses ( , same as ) for a given article ( ) response_ids article_ids article_id You can treat pretty much same as . To see the content of the response, use the endpoint. Note: response_id aritcle_id Get Article's Content Endpoint - GET /article/{article_id}/responses Usage - https://gist.github.com/weeping-angel/5e7b360bd7e3a03e3035a036a50e22c8?embedable=true GET Article's Fans This endpoint returns a list of of the people who clapped on the article. user_ids You can use the endpoint to retrieve information on individual users. GET User Info Endpoint - GET /article/{article_id}/fans Usage - https://gist.github.com/weeping-angel/dc15a0310469816a9b0317b975da24a8?embedable=true GET Related Articles This endpoint returns a list of of the related posts. article_ids (Length = 5) If the article is self-published, related posts will belong to the same author. Else, related posts will belong to the publication in which the article is published. Note: Endpoint - GET /article/{article_id}/related Usage - https://gist.github.com/weeping-angel/8157dcb20427892dfe12d06ef3406217?embedable=true GET Publication ID Every Medium Publication has one unique hash ID associated with it. Usually, we only deal with that is generated when we choose our Publication's Name. You can find your in the homepage URL of your publication. Like - publication_slug publication_slug https:// medium.com / publication_slug Once you get your , you can use the following endpoint to get your . publication_slug publication_id Endpoint - GET /publication/id_for/{publication_slug} Usage - https://gist.github.com/weeping-angel/dbd1ee3e532789a662f85b54a9449bdc?embedable=true GET Publication Info This endpoint returns publication-related information such as for the corresponding . Publication name, Tagline, Description, Tags, Followers Count, Creator, Editors, Twitter username, Instagram username, Facebook Page name, Logo, Domain, etc ... publication_id A is the unique hash ID associated with every Medium Publication. For example, of is publication_id publication_id TowardsDataScience "7f60cf5620c9". If you don't know the , you can get it from any article published under it. Use the endpoint to retrieve the . Or, if you know the , use the endpoint . publication_id , GET Article Info publication_id publication_slug GET Publication ID Endpoint - GET /publication/{publication_id} Usage - https://gist.github.com/weeping-angel/e73f4c180b71fed2de9160dff38d25be?embedable=true GET Publication Articles This endpoint returns the list of of the latest 25 articles, posted recently in that publication. articles_ids You can use the endpoint to retrieve information on individual articles. GET Article Info Query Parameter (Optional): - : Use the query parameter to get the articles before that date and time. from from Endpoint - GET /publication/{publication_id}/articles Usage - https://gist.github.com/weeping-angel/d4ba88bd29cf3482927e77e87ed236d7?embedable=true GET Publication's Newsletter This endpoint returns information related to the associated newsletter for the given publication. This includes their , name, description, creator's id subscriber's count, unique id, image url, etc... Endpoint - GET /publication/{publication_id}/newsletter Usage - https://gist.github.com/weeping-angel/4ed062ced5c2068cec38567f62d497f4?embedable=true GET Latest Posts This endpoint returns a list of the latest posts ( ) under a topic/niche (as classified and by the Medium platform). article_ids distributed Examples of a topic/niche can be: blockchain artificial-intelligence relationships mental-health, etc ... These are known as . (Not same as ) topic_slugs tags At any given moment, this endpoint will return a list of 25 articles ( ). You can then endpoint to retrieve information related to each article. article_ids GET Article Info Endpoint – GET /latestposts/{topic_slug} Usage – https://gist.github.com/weeping-angel/dad4f1382928798b5d2dbfd1fd9c8c38?embedable=true GET Top Writers This endpoint returns a list of top writers ( ) within a particular topic/niche (using ). user_ids topic_slug Examples of are – topic_slug blockchain relationships artificial-intelligence, etc ... You can use an optional query parameter to specify the number of top writers you want to retrieve. count Maximum number of top writers within a topic will be 250. Note: After fetching the , you can use the endpoint to extract information related to the individual users. user_ids GET User Info Endpoint – GET /top_writers/{topic_slug} GET /top_writers/{topic_slug}?count={count} Usage — https://gist.github.com/weeping-angel/9217562c854f85a2c949fb497ceb8cbc?embedable=true GET Top Feeds This endpoint returns a list of (default count = 25) for the given and . article_ids tag mode Example of a will tag ‘blockchain', ‘defi', ‘artificial-intelligence', etc... Mode: : For getting trending articles hot : For getting the latest articles new : For getting the best articles of the year top_year : For getting the best articles of the month top_month : For getting the best articles of the week top_week : For getting the best articles of all time top_all_time You can use the endpoint to retrieve information related to each article. Note: GET Article Info Query Parameters ( ): - Optional To get the subsequent top feeds, it can also take a query string parameter called , where, < 250. after after To limit the number of top feeds, use another query string parameter called , where < 25. count count Endpoint - GET /topfeeds/{tag}/{mode} Usage - https://gist.github.com/weeping-angel/8be504accef43976d161cd0b72c23009?embedable=true Get Tag Info This endpoint returns tag-related information for the given . This includes: tag Tag Name Followers Count Number of stories Number of writers Number of latest stories Number of latest writers are lowercased, hyphen-separated strings representing a category or niche on Medium Platform Note: tags Endpoint - GET /tag/{tag} Usage - https://gist.github.com/weeping-angel/03c46c14b2e9be11ca61d724dad3694d?embedable=true Get Related Tags This endpoint returns a list of for a given . related_tags tag For the tag , it will return . Example: blockchain "cryptocurrency", "bitcoin", "ethereum", "crypto", "ico", "technology", "defi", "nft", "fintech" Endpoint - GET /related_tags/{tag} Usage - https://gist.github.com/weeping-angel/6a0628389b1b1b27b9cc893c7c0181f4?embedable=true GET List Info This endpoint returns the Medium's information - such as for the given list-related id, name, author, description, thumbnail image url, creation datetime, last modified datetime, number of articles in the list, claps, voters, and comments - list_id . The is the unique hash ID associated with every Medium List. You can see it at the end of the URL as follows: list_id https:// /list/medium-api- nishu-jain.medium.com 38f9e0f9bea6 Here is the . 38f9e0f9bea6 list_id Endpoint - GET /list/{list_id} Usage - https://gist.github.com/weeping-angel/f3c985b9626491950f379d25ea0c7e12?embedable=true GET List Articles This endpoint returns an array of present in the given Medium List. article_ids You can use the endpoint to retrieve information on individual articles. GET Article Info Endpoint - GET /list/{list_id}/articles Usage - https://gist.github.com/weeping-angel/8c5fcebc9b90574209a00fe82651dc8b?embedable=true GET List Responses This endpoint returns an array of for the given Medium List. response_ids You can treat pretty much same as . To see the content of the response, use the endpoint. Note: response_id aritcle_id Get Article's Content Endpoint - GET /list/{list_id}/responses Usage - https://gist.github.com/weeping-angel/e6668982cef713eff2ac41e95013d442?embedable=true Search Articles This endpoint returns a list of that match the search query. The maximum length of this list will be 1000. If no articles are found that match the search query, then an empty list will be returned. article_ids Query Parameter : - (Required) : A string parameter that specifies the search query for which the articles need to be retrieved. query You can use the endpoint to retrieve information on individual articles. GET Article Info Endpoint - GET /search/articles?query={query} Usage - https://gist.github.com/weeping-angel/11c71118c79feeb2deea8552c77ca04c?embedable=true Search Publications This endpoint returns a list of that match the search query. The maximum length of this list will be 1000. If no publications are found that match the search query, then an empty list will be returned. publication_ids Query Parameter : - (Required) : A string parameter that specifies the search query for which the publications need to be retrieved. query You can use the endpoint to retrieve information on individual publications. GET Publication Info Endpoint - GET /search/publications?query={query} Usage - https://gist.github.com/weeping-angel/e24d6a9462175e8df40d11fec1d60a05?embedable=true Search Users This endpoint returns a list of that match the search query. The maximum length of this list will be 1000. If no users are found that match the search query, then an empty list will be returned. user_ids Query Parameter (Required): - : A string parameter that specifies the search query for which the users need to be retrieved. query You can use the endpoint to retrieve information on individual users. GET User Info Endpoint - GET /search/users?query={query} Usage - https://gist.github.com/weeping-angel/f5e63f8b87fb284d3562390093ac71a5?embedable=true Search Lists This endpoint returns an array of that match the search query. The maximum length of this array will be 1000. If no Medium Lists are found that match the search query, then an empty array will be returned. list_ids Query Parameter (Required): - : A string parameter that specifies the search query for which the Medium Lists need to be retrieved. query You can use the endpoint to retrieve information on individual Medium Lists. GET List Info Endpoint - GET /search/lists?query={query} Usage - https://gist.github.com/weeping-angel/21a7f30b191462850d236f55afb0fd23?embedable=true Search Tags This endpoint returns a list of that match the search query. The maximum length of this list will be 1000. If no tags are found that match the search query, then an empty list will be returned. tags Query Parameter : - (Required) : A string parameter that specifies the search query for which the tags need to be retrieved. query Endpoint - GET /search/tags?query={query} Usage - https://gist.github.com/weeping-angel/af8db800bc22ad5b226d58d5314a514b?embedable=true Final thoughts As of now, this API consists of 33 endpoints, all of which use the GET method. I'll try to add more endpoints in the future and improve its efficiency to provide you with the best [Unofficial] Medium API possible. You can subscribe to this API here: Medium API - RapidAPI Read its Swagger documentation here: API Documentation And if you're a Python programmer, do . Visit the following link to learn more about Unofficial Medium API's Python SDK. pip install medium-api GitHub - weeping-angel/medium-api If you've any thoughts on it, feel free to share them. I'll appreciate your feedback and try to improve it further. My email ID: nishu@mediumapi.com Thanks for reading and have a wonderful day! We post tutorials, videos, code snippets, and insights related to Medium and Unofficial Medium API. So be sure to follow us on: PS: Twitter: twitter.com/medium_api LinkedIn: www.linkedin.com/company/medium-api Also published . here

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Your Official Guide to the Unofficial Medium Dotcom API for Fetching Data

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

Spotting a Short-Sighted Developer in the Wild

Spotting a Short-Sighted Developer in the Wild

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps