# Medium API (Unofficial)

> Medium API allows developers to reliably fetch clean, structured data from [Medium's website](https://medium.com). It supports data extraction for users, articles, publications, search results, lists, top writers, top articles, and more. The API is available on the [RapidAPI Hub](http://hub.mediumapi.com).

Note: This is a RESTful API with 42 GET-only endpoints, all returning data in JSON format.

## How to use Medium API

1. Sign up at [RapidAPI](https://rapidapi.com/auth/sign-up) (if you haven't already).

2. Get your API key from [Medium API](http://hub.mediumapi.com) page.

3. Go to the pricing page and choose a plan - BASIC, PRO, ULTRA or MEGA. Enter your payment details and press subscribe!

4. Authenticate requests by passing your API key in the `x-rapidapi-key` header.

**Note:** For testing purposes, start with our BASIC free plan. It includes 150 API calls per month.

For a more detailed step-by-step guide on how to subscribe to Medium API and get your API key, please read the following articles:

https://mediumapi.com/how-to-subscribe-to-medium-api.html

## Documentation

All about Medium API endpoints, their request parameters and output responses.

- [Full detailed Documentation](https://mediumapi.com/documentation.html)
- [Swagger Documentation](https://docs.mediumapi.com)
- [RapidAPI Playground](http://hub.mediumapi.com)

### List of all endpoints

https://mediumapi.com/#endpoints

**User**

- User ID
- User Info
- User Articles
- User Top Articles
- User Books
- User Followers
- User Following
- User Lists
- User Publications
- User Publication Following
- User Interests

**Article**

- Article Info
- Article Content
- Article Markdown
- Article HTML
- Articles Responses
- Article Fans
- Article Assets
- Related Articles
- Recommended Articles

**Publication**

- Publication ID
- Publication Info
- Publication Articles
- Publication Newsletter

**Search**

- Search Articles
- Search Users
- Search Publications
- Search Lists
- Search Tags

**List**

- List Info
- List Articles
- List Responses

**Platform**

- Archived Articles
- Top Feed
- Top Writers
- Recommended Feed
- Recommended Users
- Recommended Lists
- Tag Info
- Related Tags
- Root Tags
- Latest Posts

## Python SDK

Installation: `pip install medium-api`

- [GitHub](https://github.com/weeping-angel/medium-api)
- [PyPI](https://pypi.org/project/medium-api)
- [ReadTheDocs](https://medium-api.readthedocs.io)
- [Examples](https://medium-api.readthedocs.io/en/latest/usage.html)
- [Tutorials](https://mediumapi.com/how-to/)

## Javascript SDK

Installation: `npm i medium-api-js`

- [GitHub](https://github.com/weeping-angel/medium-api-js)
- [NPM](https://www.npmjs.com/package/medium-api-js)
- [Tutorials](https://mediumapi.com/how-to/)

## Blogs


- [Soft Limit vs Hard Limit | Subscription Plans | Medium API (Unofficial)](https://mediumapi.com/what-is/soft-limit-and-hard-limit.html)
- [What is Medium? | Fundamentals of Medium | Medium API (Unofficial)](https://mediumapi.com/what-is/medium.html)
- [What is Article ID? | Medium API (Unofficial)](https://mediumapi.com/what-is/article-id.html)


- [Why Manually Scraping Data from Medium is a Bad Idea](https://mediumapi.com/manual-web-scraping-vs-medium-api.html)
- [How To Retrieve Medium Stories For A User From The API?](https://mediumapi.com/retrieve-medium-stories-for-a-user-from-the-api.html)
- [The Most Important Skill for CryptoJunkies 👾](https://mediumapi.com/most-important-skill-for-cryptojunkies.html)
- [How to Find the Top Readers of a Medium Publication Using Python](https://mediumapi.com/find-top-readers-of-publication.html)
- [How To Subscribe to Medium API | Get Your API Key | RapidAPI](https://mediumapi.com/how-to-subscribe-to-medium-api.html)
- [How Crypto People Can Use Medium API?](https://mediumapi.com/how-crypto-people-can-use-medium-api.html)
- [Why Medium's RSS Feed Sucks](https://mediumapi.com/medium-rss-feed-sucks.html)
- [How To List Hundreds of Niche Top Writers of Medium](https://mediumapi.com/list-top-writers-of-medium.html)
- [How To Convert Medium Articles In Markdown Format](https://mediumapi.com/convert-medium-article-to-markdown.html)
- [Best Metric to Judge a Medium Article's Popularity](https://mediumapi.com/best-metric-to-judge-medium-articles-popularity.html)
- [Frequently Asked Questions - Medium API](https://mediumapi.com/frequently-asked-questions.html)
- [How To Get Articles Written By a Medium User Using JavaScript](https://mediumapi.com/get-medium-users-article-using-javascript.html)
- [Convert Medium Articles to Plain HTML](https://mediumapi.com/convert-medium-articles-to-plain-html.html)
- [Why People Like to Publish on Medium?](https://mediumapi.com/why-writers-love-medium-but-readers-get-annoyed.html)
- [How To Leverage Medium for Crypto-trading](https://mediumapi.com/leverage-medium-for-crypto-trading.html)
- [Unofficial Medium API: Get Posts Using Node.js](https://mediumapi.com/get-posts-using-nodejs.html)
- [Authenticate Medium Users Using Unofficial Medium API](https://mediumapi.com/authenticate-medium-users.html)
- [Real-Time Medium Notifications for Blockchain Startups](https://mediumapi.com/realtime-notifications-from-medium.html)
- [Should You Write About Medium on Medium?](https://mediumapi.com/should-you-write-about-medium-on-medium.html)
- [Medium API: Get Posts Using Python](https://mediumapi.com/get-posts-using-python.html)
- [Unofficial Medium API: Get Posts Using Python](https://mediumapi.com/get-user-posts-using-python-requests.html)

## Python SDK (How-To)


- [How to Get Top Medium Writers for the given Tag (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-top-medium-writers-for-given-tag.html)
- [How to Get Related Medium Articles to a Given Article (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-related-medium-articles-for-the-given-article.html)
- [How to Search for Articles on Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/search-articles-on-medium.html)
- [How to Get Medium Article's Textual Content (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-article-textual-content.html)
- [How to Get Recommended Articles from Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-recommended-medium-articles.html)
- [How to Get Articles from a Medium List (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-articles-from-a-medium-list.html)
- [How to Get Latest Medium Posts by Topic (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-latest-medium-posts-by-topic.html)
- [How to Get Root Tags from Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-root-tags-from-medium.html)
- [How to Search for Tags on Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/search-tags-on-medium.html)
- [How to Get Medium Publications a User is Following (Using Medium API Python Package) ](https://mediumapi.com/how-to/python-sdk/get-publications-user-following-on-medium.html)
- [How to Get a Medium Article Information (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-article-information.html)
- [How to Get Recommended Feed Articles from Medium by Tag (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-recommended-feed-articles-from-medium.html)
- [How to Get Articles from a Medium Publication (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-articles-from-medium-publication.html)
- [How to Get Media Assets from a Medium Article (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-images-videos-links-assets-from-a-medium-article.html)
- [How to Search Lists on Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/search-lists-on-medium.html)
- [How to Get Responses or Comments on a Medium List (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-comments-or-responses-on-a-medium-list.html)
- [How to Get Related Tags (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-related-tags-from-medium.html)
- [How to Get Books Published by a Medium User (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-books-published-by-medium-author.html)
- [How to Get a Medium Article in Markdown Format (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-article-in-markdown-format.html)
- [How to Get Recommended Medium Users by Tag (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-recommended-medium-authors-for-given-tag.html)
- [How to Get a Medium User's ID (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-user-id-for-given-username.html)
- [How to Get Archived Medium Articles (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-archived-medium-articles.html)
- [How to Get Responses or Comments from a Medium Article (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-responses-or-comments-from-a-medium-article.html)
- [How to Get the Top 10 Articles from a Medium User (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-the-top-10-articles-written-by-a-medium-user.html)
- [How to Get Medium List Information (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-list-information.html)
- [How to Search for Users on Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/search-users-on-medium.html)
- [How to Get Medium Lists Created by a User (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-lists-created-by-user.html)
- [How to Get Medium Publication Newsletter Information (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-publication-newsletter-information.html)
- [How to Get Medium User Information (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-user-information.html)
- [How to Get Top Feeds from Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-top-feeds-from-medium.html)
- [How to Get Tags in Which a User is Interested (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-tags-in-which-user-is-interested.html)
- [How to Get Medium Publication Information (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-publication-information.html)
- [How to Get a Medium User's Following (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-users-following.html)
- [How to Get Medium Publications Where User is Writer or Editor (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-publications-where-user-is-writer-or-editor.html)
- [How to Get a Medium User's Articles (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-users-articles.html)
- [How to Save a Medium Article as HTML (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/save-medium-article-as-html.html)
- [How to Get Recommended Lists from Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-recommended-medium-lists.html)
- [How to Get Tag Information from Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-tag-information-from-medium.html)
- [How to Get a Medium User's Followers (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-users-followers.html)
- [How to Get Fans (people who clapped) of a Medium Article (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-people-who-clapped-on-a-medium-article.html)
- [How to Search Publications on Medium (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/search-publications-on-medium.html)
- [How to Get a Medium Publication ID (Using Medium API Python Package)](https://mediumapi.com/how-to/python-sdk/get-medium-publication-id-for-given-publication-slug-or-domain-name.html)

## Javascript SDK (How-To)


- [How to Fetch Top Medium Authors for a Given Tag | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-top-medium-writers-for-given-tag.html)
- [How to Fetch Related Medium Stories to a Given Story | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-related-medium-articles-for-the-given-article.html)
- [How to Search for Stories on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/search-articles-on-medium.html)
- [How to Fetch Medium Story's Content | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-article-textual-content.html)
- [How to Retrieve Recommended Posts from Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-recommended-medium-articles.html)
- [How to fetch posts from a specific list | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-articles-from-a-medium-list.html)
- [How to Fetch Latest Medium Articles by Topic | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-latest-medium-posts-by-topic.html)
- [How to Fetch Root Tags from Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-root-tags-from-medium.html)
- [How to Search for Tags on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/search-tags-on-medium.html)
- [How to Fetch Medium Publications a User is Following | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-publications-user-following-on-medium.html)
- [How to Retrieve a Medium Story Information | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-article-information.html)
- [How to Retrieve Recommended Feed Articles from Medium by Tag | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-recommended-feed-articles-from-medium.html)
- [How to fetch stories from a Medium Publication | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-articles-from-medium-publication.html)
- [How to Fetch Story Assets | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-images-videos-links-assets-from-a-medium-article.html)
- [How to Search Lists on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/search-lists-on-medium.html)
- [How to fetch Responses (Comments) on a Medium List | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-comments-or-responses-on-a-medium-list.html)
- [How to Fetch Related Tags on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-related-tags-from-medium.html)
- [How to retrieve Books Published by a Medium Writer | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-books-published-by-medium-author.html)
- [How to fetch a Medium Story in Markdown Format | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-article-in-markdown-format.html)
- [How to Get Recommended Medium Users by Tag | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-recommended-medium-authors-for-given-tag.html)
- [How to Fetch a Medium User's ID | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-user-id-for-given-username.html)
- [How to Retrieve Archived Medium Posts | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-archived-medium-articles.html)
- [How to Retrieve Story Responses | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-responses-or-comments-from-a-medium-article.html)
- [How to Retrieve the Top Stories of a Medium User | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-the-top-10-articles-written-by-a-medium-user.html)
- [How to Retrieve Details of a Specific Medium List | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-list-information.html)
- [How to Search for Users on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/search-users-on-medium.html)
- [How to Fetch Medium Lists Created by a User | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-lists-created-by-user.html)
- [How to Retrieve Medium Publication Newsletter Information | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-publication-newsletter-information.html)
- [How to Fetch Medium User Information | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-user-information.html)
- [How to Fetch Top Feeds from Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-top-feeds-from-medium.html)
- [How to Fetch Tags in Which a User is Interested | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-tags-in-which-user-is-interested.html)
- [How to Retrieve Medium Publication Information | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-publication-information.html)
- [How to Fetch a Medium User's Following | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-users-following.html)
- [How to Retrieve Medium Publications Where the User is a Writer or Editor | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-publications-where-user-is-writer-or-editor.html)
- [How to Fetch a Medium User's Articles | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-users-articles.html)
- [How to Save a Medium Story as HTML | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/save-medium-article-as-html.html)
- [How to Fetch Recommended Lists from Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-recommended-medium-lists.html)
- [How to Retrieve Tag Information from Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-tag-information-from-medium.html)
- [How to Fetch a Medium User's Followers | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-users-followers.html)
- [How to Fetch Fans (People Who Clapped) of a Medium Article | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-people-who-clapped-on-a-medium-article.html)
- [How to Search Publications on Medium | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/search-publications-on-medium.html)
- [How to Fetch a Medium Publication ID | Using Medium API Javascript Package](https://mediumapi.com/how-to/javascript/get-medium-publication-id-for-given-publication-slug-or-domain-name.html)

## Other services

- [Medium Portfolio Pages](https://mymedium.info): It's a cool, self-updating, shareable portfolio page that flaunts your Medium experience – from highlighting your key stats to featuring your top articles. Showcase your writing journey with Medium Portfolio Pages.

## Socials

- [LinkedIn](https://www.linkedin.com/company/medium-api)
- [X (formerly known as Twitter)](https://x.com/medium_api)
- [YouTube](https://www.youtube.com/@medium-api)
- [Email](mailto:nishu@mediumapi.com)

## Notes

- Our BASIC (free) plan includes a soft monthly limit of 150 API calls. If you exceed this limit, additional calls will be billed at $0.04 per request. Please keep this in mind to avoid unexpected charges.

- All paid plans (PRO, ULTRA, and MEGA) have hard usage limits, so you won’t incur any overage fees beyond your plan.

- By using our API, you agree to our Terms of Service. Please review them carefully. Scraping copyrighted content for commercial use without the explicit permission of the original author(s) is prohibited.

- For feedback, bug reports, or questions, feel free to reach out to nishu@mediumapi.com.