DEV Community: Nishu Jain

How To Convert Medium Articles In Markdown Format

Nishu Jain — Sat, 30 Sep 2023 18:00:00 +0000

Medium Articles → Markdown → HTML

There are several reasons why you might want to convert a Medium article from its original format to Markdown and then to HTML. In this article, I'll explain to you how you can do it using Python programming language with a few simple steps.

Why might you wanna do it?

Some of the benefits of using Markdown include:

Markdown is a simple, lightweight markup language that is easy to read and write. This makes it a convenient format for storing and editing articles, especially when compared to more complex formats such as HTML or XML.
Markdown supports a wide range of formatting options, such as headings, lists, links, and more, that can be applied using a simple and intuitive syntax. This allows you to add structure and formatting to your articles without having to use complex tags or styles.
Markdown is supported by a wide range of tools and platforms, including text editors, publishing systems, and more. This makes it easy to work with Markdown content and allows you to integrate your articles with other applications or services.
Markdown is a widely used and well-documented format with a large and active community of users. This means that you can easily find resources and support for working with Markdown and can share your articles with others who use the format.

Overall, converting a Medium article to Markdown can provide many benefits, such as making it easier to edit and format the article and enabling you to integrate it with other tools and platforms.

Whether or not this is the right approach for you will depend on your specific needs and goals.

Now let's jump to the code!

Python Code to convert Medium Article into Markdown and HTML

Code Explanation -

The code you provided is a Python script that uses the medium_api library to access the Unofficial Medium API and convert an article from Markdown to HTML.

You can install medium-api using the following command:

pip install medium-api

Here is a brief explanation of what the code does:

The first two lines import the os and markdown libraries, which are used to access environmental variables and convert Markdown to HTML, respectively.

The third line imports the Medium class from the medium_api library, which is used to access the Unofficial Medium API.

The next three lines extract the ID of an article from its URL, and use the Medium object to retrieve the article data from the API. This data is stored in an article object.

The eighth line uses the markdown library to convert the article's Markdown content to HTML, and stores the result in a variable named html_output.

The last three lines write the HTML to a file named index.html, replacing all occurrences of the ( ' ) character with a single quote.

Overall, this code demonstrates how to use the medium_api library to access the Unofficial Medium API and convert an article from Markdown to HTML. It is not a complete application but rather a sample of how the API can be used in a Python script.

Resources 🚀

You can subscribe to Unofficial Medium API here: Medium API - RapidAPI
Read its Swagger documentation: Medium API - Documentation
Bookmark Python SDK's GitHub repository: Medium API - GitHub
See more example usage here: Medium API - ReadTheDocs

Thanks for reading, and have a nice day!

PS: We post tutorials, videos, code snippets, and insights related to Medium and our API. So be sure to follow us on:

Twitter: twitter.com/medium_api
LinkedIn: www.linkedin.com/company/medium-api

Related Articles -

Unofficial Medium API - Frequently Asked Questions

Nishu Jain — Wed, 27 Sep 2023 17:30:00 +0000

This is the list of most frequent questions that I get from people who come across our Unofficial Medium API. If your question is not answered here, please feel free to email me at "nishu@mediumapi.com".

Does Medium have an API? Or, Is there an API for Medium?

Yes, Medium has its Official API on Github, but it is no longer maintained. It was primarily focused on publishing articles on Medium, programmatically, but you could not extract any significant data using it.

To overcome this limitation, I developed the Unofficial Medium API. Using this, you can fetch anything and everything from Medium.

Check out its documentation to learn more about its powerful features and capabilities. From fetching articles, authors, publications, and more, the Unofficial Medium API provides a complete and flexible solution for all your data extraction needs from Medium.

Whether you're a marketer, researcher, or developer, you can easily access the valuable insights and information stored on Medium with this API.

So why settle for the limited official API when you can have the full power of the Unofficial Medium API at your fingertips?

Upgrade your Medium data extraction today!

Unofficial Medium API - Documentation

Is our Unofficial Medium API free?

Our Unofficial Medium API has a freemium model. We provide 150 free calls per month on our Basic plan. It'll give you plenty of room to try and test it for your particular solution.

But if your requirement is higher, we recommend you upgrade your plan - Pro, Ultra, or Mega - for more API calls.

💡 Check out our very generous pricing on RapidAPI. 🦑

For large-scale production use, email me at "nishu@mediumapi.com". We can build custom endpoints for you to save bandwidth, and give you flat rates for unlimited usage.

How do I use this Unofficial Medium API?

To use Unofficial Medium API, go to our RapidAPI listing and subscribe it!

There you'll get your API Key to authenticate your calls. This will also keep track of your usage, so please remember to keep it a secret.

Once you're subscribed and have the API Key, you can start programming in your favorite language.

✨ Bonus Tip: If you're a Python Developer, then you can use our Unofficial Medium API's SDK.

$ pip install medium-api

Go to our Github repository to get started!

How do I get data from the Unofficial Medium API?

To get data from our Unofficial Medium API, you'll have to make GET request to your desired endpoint, along with the API Key in the headers. Your header will look like this:

x-rapidapi-key: [YOUR_API_KEY]

In response, our server will quickly return a JSON object containing the related data points and attributes in the form of key-value pairs.

Base API URL -

GET https://medium2.p.rapidapi.com/

To try and test all the endpoints, use RapidAPI's Playground. There, you can also get the code in your favorite programming language to call the API.

For an in-depth explanation of each endpoint, read our awesome documentation here on Medium:-

Unofficial Medium API - Documentation

How do you find Medium Stats?

For obvious reasons, our Unofficial Medium API cannot fetch your private information, such as the number of reads on your articles, total reading time, your Medium earnings, etc...

However, it can fetch a number of claps, voters, and comments on your articles to estimate their popularity.

Best Metric to Judge a Medium Article's Popularity

There are more than 15 data points that you can get from Article Info Endpoint alone. And you can gather pretty interesting insights from them.

For example; you can perform rigorous data analysis on any Medium user's profile by fetching all their articles.

What can you find by getting a bunch of articles?

See in which publications they like to post their work.
Find exactly when they're publishing their articles - Which time, weekday, or dates of the month.
Which topics they're covering in their niches, or what's trending?
Perform sentiment analysis or some advanced NLP technique to go further deep to find their secret.

Your options are just limited by your imagination!

Note: Further in this article, by "Medium Stats" we mean the data points that you can get from our API. Publicly available information.

Can you download Medium Stats?

From Medium, Not yet :(

From Unofficial Medium API, Absolutely yes! (Please read the answer above)

Since you're reading this, I'm assuming you've basic programming skills. If not, then don't worry ... email me at "nishu@mediumapi.com" and describe exactly what you want to do.

Using our API, you can fetch all kinds of data from Medium and save/download it wherever you want. Like on your computer, database, or flat files, or cloud, etc ...

Personally, I like to download and save all my stats in CSV files that I can open in Excel or Spreadsheet later. These files can easily be consumed by data pipelines and data processing libraries like Pandas (in Python).

We can then plug these Pandas Dataframes into ML projects and perform analysis and visualization to hunt for insights.

Can people read Medium Articles for free? Or, Are Medium articles free? Or, How to get free Medium Articles?

It is no secret that people, who are not subscribed to Medium, can read members-only articles in the browser's incognito mode. In that sense, Medium articles are free and publicly available to all.

[UPDATE]: Recently, Medium made some changes to their platform and now people cannot read Medium Articles for free in incognito mode.

Using our API, you can fetch Medium Article's details, its textual content, and markdown for free programmatically.

⚠️ Disclaimer: It is not advisable to abuse this content-extraction functionality of our API to re-publish or distribute Medium Users' Work without their explicit permission. We are not responsible for any copyright infringement, plagiarism, or illegal activity performed by an API user. This functionality of this Unofficial Medium API is intended for personal usage and data analytics purposes only.

Please go through our Terms of Use before using Unofficial Medium API.

Have more questions? Feel free to email us at "nishu@mediumapi.com" and we would be happy to answer them all!

Convert Medium Articles to HTML

Nishu Jain — Sun, 24 Sep 2023 16:15:00 +0000

Hey Guys!

We are happy to announce that we have added a new, powerful endpoint to Medium API to extend its functionality, called "Get Article's HTML". As the name suggests, this endpoint returns the Medium Article in plain HTML format.

You can read more about its usage here.

In this article, we will explore the intricacies of the HTML structure obtained through the output of this new endpoint. We will dive deep into the underlying elements, classes, and tags that compose the structure of Medium articles.

In our discoveries, one of the major applications we have found of this endpoint is to sync up your Medium articles with your personal portfolio website.

If you don't want to build a backend just for publishing articles, then you can use Medium as your blogging backend. Medium API enables you to import/sync your Medium Articles with ease.

And understanding the structure of the output HTML will empower you to effortlessly adapt and style your imported Medium articles, ensuring they seamlessly blend with the unique design and layout of your website.

So let's get started!

Quick refresh: Here is the output of the "Article's HTML" endpoint.

Fullpage Parameter

Before we dive into each tag, an important aspect to note is the presence of the "fullpage" parameter that you can use with this endpoint.

By toggling this parameter to true, you can obtain the complete HTML page, including the head, body, title, and meta tags.

Alternatively, setting it to false retrieves only the HTML content within the body.

Choosing to save the full HTML page (fullpage = true) provides additional information that can prove beneficial for various purposes, particularly in the realm of Search Engine Optimization (SEO).

You'll also notice the presence of multiple meta tags in the example. They are primarily used by search engines, social media platforms, and browsers to understand and display information about the webpage.

These meta tags provide various types of information about the webpage, including its character encoding, compatibility mode, view-port settings, description, keywords, authorship, and information used by social media platforms when the page is shared.

Now let's come to the main part of the HTML.

Understanding the HTML Structure

Here, we will take a closer look at the various tags present in the HTML structure of a Medium article.

From the eye-catching headings to the captivating images, the impactful quotes to the informative code blocks, we will examine the purpose and functionality of each tag.

Kicker, Title & Subtitle

These elements form the backbone of an engaging Medium article by capturing the reader's attention and conveying the essence of the content.

The kicker acts as a catchy introduction, while the title succinctly summarizes the main topic. Subtitles provide additional context or highlight key aspects.

By utilizing the <h3>, <h1>, and <h3> tags respectively, these elements are given the prominence they deserve.

Here's an example:

Images

Moving on to images - they enhance the visual appeal of an article and help convey information more effectively.

The <img> tag is used to insert images into the article, as seen in the example:

Here, the alt text is taken from your Image's caption and src attribute specifies the Image's URL stored on Medium server.

Codeblocks

Code snippets are an essential part of technical articles, as they allow readers to understand specific programming instructions.

To represent codeblocks in our HTML structure, the <pre> and <code> tags are utilized, providing a designated space for code content. And the class attribute allows you to specify the language for syntax highlighting.

By enclosing code within these tags, it maintains the formatting and preserves indentation, making it easier for readers to read and comprehend the code.

This ensures that code snippets are visually distinct from the surrounding text, allowing for better clarity and understanding.

Quotes

Quotes serve as powerful tools for emphasizing key statements or insights within an article.

In our HTML structure, quotes are represented using the <blockquote> tag.

This tag allows for the distinct styling and presentation of quoted content. By applying different classes, such as "big" or "small," you can make them stand out differently to capture the reader's attention.

Basic Formatting

HTML tags like <b>, <i>, and <a> provide powerful means to format and enhance the textual content of Medium articles.

<b> tag is used to bold the text
<i> for making it italic
<a> for creating clickable hyperlinks

These tags allow us to apply emphasis, highlight important information, and seamlessly integrate external references within the article.

In the image, we can observe examples of both formatting and links:

These examples showcase different combinations of <b> and <i> tags to create bold, italic, or both formatting styles applied to specific portions of the text.

The <a> tag is used to create a clickable hyperlink, where href attribute specifies the URL that the link should point to, and the text "Link" serves as the visible text for the hyperlink.

Lists

Lists are valuable tools for organizing information in a structured and readable format within Medium articles.

Here, we have two types of lists:

ordered lists represented by the <ol> (ordered list) tag
unordered lists represented by the <ul> (unordered list) tag

In the ordered list example, the <ol> tag is used to create a numbered list. Each list item is represented by the <li> (list item) tag. The numbers indicate the sequence or order of the items.

In the unordered list example, the <ul> tag is used to create a bullet-point list. Similar to the ordered list, each item is represented by the <li> tag. However, in this case, the items are presented without any particular order or sequence.

Lists are particularly useful when presenting steps, instructions, bullet points, or any form of organized information.

They help readers easily digest and navigate through the content, improving the overall readability and comprehension of the article.

Inline Code

Inline code snippets are an important aspect of technical articles. They allow us to highlight and distinguish code within the regular text. In our HTML structure, the <code> tag is utilized to represent inline code snippets.

This tag enhances the clarity and readability of our Medium articles, especially when discussing code-related concepts, syntax, or examples.

Embeds

Embedding external content in Medium articles elevates the level of interactivity, transforming them into immersive experiences. By seamlessly integrating dynamic elements such as code snippets, interactive widgets, or multimedia content, we captivate our readers and provide them with engaging and enriched articles.

In our HTML structure, different types of embeds get converted into different kinds of tags.

Let's see a couple of examples:

GitHub Gist Embed

YouTube Video Embed

Final thoughts -

You have now acquired a thorough comprehension of the new "Get Article's HTML" endpoint in the Medium API, along with the wide array of tags encompassed in its output.

Armed with this knowledge, you can effortlessly incorporate the endpoint's output into your existing infrastructure, and even tailor your own custom CSS to align with your company's branding.

Should you have any inquiries, uncertainties, or suggestions regarding this endpoint or its output, please feel free to reach out to us at -

nishu@mediumapi.com

Thanks for reading and have a nice day!

Unofficial Medium API: Get Posts Using Python

Nishu Jain — Thu, 21 Sep 2023 14:30:00 +0000

Hey guys!

Welcome back to another tutorial for Unofficial Medium API. Today I will teach you how you can get posts from Medium using Python programming language.

By the end of this article, you will be able to extract any user-written articles, any stories published by a publication, and posts published with certain tags.

You can use any programming language of your choice here since we're using a REST API. But here, I'll focus on Python only since we have an SDK ready, which will make our life easier.

If you're coding in any other language, such as Javascript, PHP, C/C++, or something like that, please look into this swagger documentation.

For all the Python programmers, sit tight, and let's jump to the code.

Getting posts using Medium API

To simplify the usage of Medium API, we'll install medium-api python package.

First of all, open up your favorite IDE and fire up the terminal.

Type "pip install medium-api" and hit enter.

pip install medium-api

This will install medium-api package in your python environment, so you can import it in your project.

Get User's Posts

Now, create a new Python file and name it, "get_user_articles.py"

Import the Medium class object from medium_api module. And initialize it using your API_KEY.

💡 Note: To get your API_KEY, Subscribe to our Unofficial Medium API. And don't worry, you can start by choosing the FREE plan.

Now, create a Medium User Object by passing your username (here nishu-jain). Then call fetch_articles() function, will quickly extract articles information using multi-threading.

At last, you can loop through user articles objects and print its title.

That's it!

Get Publication's Posts

Now let's create another file called "get_publication_articles.py".

Start by importing the Medium object and initializing it using your "API_KEY".

💡 Note: To get your API_KEY, Subscribe to our Unofficial Medium API. And don't worry, you can start by choosing the FREE plan.

Define a Publication object by passing the publication_id. Here, I'm using a publication called "Towards AI" as an example.

How to get the publication_id?

To get the publication ID, one of the easiest method would be to get it from an Articles object.

1. Open up any article published under that publication, and copy its URL.

2. Take the hash at the end of the URL, and create an Articles object using it.

3. Print article dot publication ID and save it somewhere else, so it can be re-used.

Now, using the get_articles_between() function, of the publication object, get all the articles published in the last week. To do so, you'll have to pass two date-time parameters, _from, and, _to.

At last, iterate through the list of last week's article objects and print their title and published dates.

Get Top feed Articles

Now let's create another file called "get_topfeeds.py".

As usual, start by importing the Medium Object, and initialize it using the API_KEY.

💡 Note: To get your API_KEY, Subscribe to our Unofficial Medium API. And don't worry, you can start by choosing the FREE plan.

Define a TopFeeds object by passing the tag and mode.

Here we can take blockchain as the example tag and mode "new", to fetch the latest blockchain articles.

Now, call the fetch_articles() function to quickly get posts using multi-threading.

At last, loop through the top feeds articles and print their title.

Final thoughts -

Once you get the Articles object, you can access several of its properties, like its - title, subtitle, author's details, publication details, claps, voters, word count, reading time, tags, topics, textual content, responses, responses count, published date, last modified date, cover image URL, language, article URL, and also, you can get the entire article in the markdown format.

Important Resources 💡

Homepage: https://mediumapi.com
GitHub: https://github.com/weeping-angel/medium-api
ReadTheDocs: https://medium-api.rtfd.io
Swagger Documentation: https://docs.mediumapi.com
RapidAPI: http://hub.mediumapi.com

PS: We post tutorials, videos, code snippets, and insights related to Medium and Unofficial Medium API. So be sure to follow us on

Twitter: twitter.com/medium_api
LinkedIn: www.linkedin.com/company/medium-api

🔗 Related Articles -

Unofficial Medium API - Documentation

Unofficial Medium API: Get Posts Using Node.js

How To Leverage Medium for Crypto-trading

How to Find the Top Readers of a Medium Publication Using Python

[Unofficial] Medium API Documentation

Nishu Jain — Sat, 09 Sep 2023 07:08:16 +0000

Hey guys!

This is the "Getting Started" Guide for the Medium API (Unofficial Version), listed on the RapidAPI Platform.

This REST API helps you to quickly extract data from medium.com, without any hassle.

Using our Unofficial Medium API, you can get -

User's - Info, Articles, Top Articles, Followers, Following, Interests, Lists, Publications
Article's - Info, Responses, Content, Markdown, HTML, Fans, Related Articles
Publication's - Info, Articles, Newsletter
Top Feeds, Latest Posts, Top Writers, Tag Info, Related Tags
List's - Info, Articles, Responses
Search - Articles, Publications, Users, Lists, Tags

💡 Checkout our swagger documentation for the details on each endpoint!

Before getting started, you must first get your API Key to authenticate your calls. You'll need to pass it in the headers, along with the requests, to use the API smoothly.

Header -

x-rapidapi-key: [RAPIDAPI_KEY]

Wondering how to subscribe to our API and get API Key? Watch the following video -

API's Base URL:

https://medium2.p.rapidapi.com

Endpoints:

User 👥 :

· GET User ID
· GET User Info
· GET User's Articles
· GET User's Top Articles
· GET User's Following
· GET User's Followers
· GET User's Interests
· GET User's Lists
· GET User's Publications

Article ✏️ :

· GET Article Info
· GET Article's Content
· GET Article's Markdown
· GET Article's HTML
· GET Article's Responses
· GET Article's Fans
· GET Related Articles

Publication 📰 :

· GET Publication ID
· GET Publication Info
· GET Publication Articles
· GET Publication's Newsletter

Misc 🌀 :

· GET Latest Posts
· GET Top Writers
· GET Top Feeds
· GET Tag Info
· GET Related Tags

List 📜 :

· GET List Info
· GET List Articles
· GET List Responses

Search 🔎 :

· Search Articles
· Search Publications
· Search User
· Search Lists
· Search Tags

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 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 nishu-jain, you can use the following endpoint to get your user_id.

Endpoint -

GET /user/id_for/{username}

Usage -

Once you have the user_id, you can invoke other user-related endpoints using it.

GET User Info

Once you've got the user_id, you can use it to get user-related information such as - Full name, Username, Bio, Followers & Following count, Twitter username, Profile-image, top writer status, etc ...

Endpoint -

GET /user/{user_id}

If you don't have the user_id, see the GET User ID endpoint above.

Usage -

GET User's Articles

This endpoint returns a list of articles (article_ids) written by the Medium user.

💡 You can then use the GET Article Info endpoint to retrieve information, such as title, subtitle, author, claps, voters, tags, topics, publication, etc..., related to your desired article.

Endpoint -

GET /user/{user_id}/articles

Usage -

GET User's Top Articles

This endpoint returns a list of aritcle_ids of the top 10 posts/articles on the user's profile (usually in chronological order - most recent posts), for the given user (user_id).

💡 You can then use the GET Article Info endpoint to retrieve information on individual articles.

Endpoint -

GET /user/{user_id}/top_aritcles

Usage -

GET User's Following

This endpoint returns a list of user_ids of the given user's followings.

You can fetch this list and use the GET User Info endpoint to retrieve information related to the individual users.

Note: Currently, this list does not contain the publication_ids of the publications that the user is following.

Query Parameters (Optional): -

count: To limit the number of results. (count <= 1500)

Endpoint -

GET /user/{user_id}/following

Usage —

GET User's Followers

This endpoint returns a list of user_ids of the followers for the given user.

Note: The length of followers' list might be different from what you get in the Get User Info Endpoint. It's because, this list doesn't include Medium Users who left the platform.

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 GET User Info endpoint to retrieve information related to the individual users.

Query Parameters (Optional): -

count: To limit the number of results. (count <= 1500)

Endpoint -

GET /user/{user_id}/followers

Usage -

GET User's Interests

This endpoint returns a list of tags that the given user follows on Medium.

All tags are lowercased hyphen-separated strings.

Endpoint -

GET /user/{user_id}/interests

Usage —

GET User's Lists

This endpoint returns an array of list_ids created by the user.

You can use the GET List Info endpoint to retrieve information on individual Medium Lists.

Endpoint -

GET /user/{user_id}/lists

Usage -

GET User's Publications

This endpoint returns a list of publication_ids where the user is the editor and/or creator.

You can use the GET Publication Info endpoint to retrieve information on individual publications.

Endpoint -

GET /user/{user_id}/publications

Usage -

GET Article Info

This endpoint returns the article-related information such as Title, Subtitle, Author, Tags, Topics (as assigned by Medium), 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 article_id at the end of any Medium Story's URL. Like -

https:// medium.com /towards-artificial-intelligence/why-its-super-hard-to-be-an-ml-researcher-or-developer- 67fa62fc1971
https:// nishu-jain.medium.com /the-neutrality-of-death- 20abb01e5c85

Endpoint -

GET /article/{article_id}

Usage -

GET Article's Content

This endpoint returns the textual content of an article/story, for the corresponding article_id.

You can get the article_id from the URL, as shown above in the GET Article Info endpoint.

Endpoint -

GET /article/{article_id}/content

Usage -

GET Article's Markdown

This endpoint returns the article content in the markdown format (.md), for the corresponding article_id.

You can get the article_id from the URL, as shown above in the GET Article Info endpoint.

Endpoint -

GET /article/{article_id}/markdown

Usage -

GET Article's HTML

This endpoint returns the article in plain HTML format (.html), for the corresponding article_id.

You can get the article_id from the URL, as shown above in the GET Article Info endpoint.

Query Parameter (Optional) : -

Set fullpage parameter to true to get the full HTML page with head, body, title and meta tags. If fullpage is set to false or not provided, the endpoint will only return the HTML inside body tag.

Endpoint -

GET /article/{article_id}/html

GET /article/{article_id}/html?fullpage=true

Usage -

GET Article's Responses

This endpoint returns a list of responses (response_ids, same as article_ids) for a given article (article_id)

Note: You can treat response_id pretty much same as aritcle_id. To see the content of the response, use the Get Article's Content endpoint.

Endpoint -

GET /article/{article_id}/responses

Usage -

GET Article's Fans

This endpoint returns a list of user_ids of the people who clapped on the article.

You can use the GET User Info endpoint to retrieve information on individual users.

Endpoint -

GET /article/{article_id}/fans

Usage -

GET Related Articles

This endpoint returns a list of article_ids of the related posts. (Length = 5)

Note: 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.

Endpoint -

GET /article/{article_id}/related

Usage -

GET Publication ID

Every Medium Publication has one unique hash ID associated with it. Usually, we only deal with publication_slug that is generated when we choose our Publication's Name. You can find your publication_slug in the homepage URL of your publication. Like -

https:// medium.com / publication_slug

Once you get your publication_slug, you can use the following endpoint to get your publication_id.

Endpoint -

GET /publication/id_for/{publication_slug}

Usage -

GET Publication Info

This endpoint returns publication-related information such as Publication name, Tagline, Description, Tags, Followers Count, Creator, Editors, Twitter username, Instagram username, Facebook Page name, Logo, Domain, etc ... for the corresponding publication_id.

A publication_id is the unique hash ID associated with every Medium Publication. For example, publication_id of TowardsDataScience is "7f60cf5620c9"

If you don't know the publication_id, you can get it from any article published under it. Use the endpoint GET Article Info, to retrieve the publication_id. Or, if you know the publication_slug, use the endpoint GET Publication ID.

Endpoint -

GET /publication/{publication_id}

Usage -

GET Publication Articles

This endpoint returns the list of articles_ids of the latest 25 articles, posted recently in that publication.

You can use the GET Article Info endpoint to retrieve information on individual articles.

Query Parameter (Optional): -

from: Use the from query parameter to get the articles before that date and time.

Endpoint -

GET /publication/{publication_id}/articles

Usage -

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 -

GET Latest Posts

This endpoint returns a list of the latest posts (article_ids) under a topic/niche (as classified and distributed by the Medium platform). Examples of a topic/niche can be:

blockchain
artificial-intelligence
relationships
mental-health, etc ...

These are known as topic_slugs. (Not same as tags)

At any given moment, this endpoint will return a list of 25 articles (article_ids). You can then GET Article Info endpoint to retrieve information related to each article.

Endpoint -

GET /latestposts/{topic_slug}

Usage -

GET Top Writers

This endpoint returns a list of top writers (user_ids) within a particular topic/niche (using topic_slug). Examples of topic_slug are -

blockchain
relationships
artificial-intelligence, etc ...

You can use an optional query parameter count to specify the number of top writers you want to retrieve.

Note: Maximum number of top writers within a topic will be 250.

After fetching the user_ids, you can use the GET User Info endpoint to extract information related to the individual users.

Endpoint -

GET /top_writers/{topic_slug}

GET /top_writers/{topic_slug}?count={count}

Usage —

GET Top Feeds

This endpoint returns a list of article_ids (default count = 25) for the given tag and mode.

Example of a tag will ‘blockchain', ‘defi', ‘artificial-intelligence', etc...

Mode:

hot : For getting trending articles
new : For getting the latest articles
top_year : For getting the best articles of the year
top_month : For getting the best articles of the month
top_week : For getting the best articles of the week
top_all_time: For getting the best articles of all time

Note: You can use the GET Article Info endpoint to retrieve information related to each article.

Query Parameters (Optional): -

To get the subsequent top feeds, it can also take a query string parameter called after, where, after < 250.
To limit the number of top feeds, use another query string parameter called count, where count < 25.

Endpoint -

GET /topfeeds/{tag}/{mode}

Usage -

Get Tag Info

This endpoint returns tag-related information for the given tag. This includes:

Tag Name
Followers Count
Number of stories
Number of writers
Number of latest stories
Number of latest writers

Note: tags are lowercased, hyphen-separated strings representing a category or niche on Medium Platform

Endpoint -

GET /tag/{tag}

Usage -

Get Related Tags

This endpoint returns a list of related_tags for a given tag.

Example: For the tag blockchain, it will return "cryptocurrency", "bitcoin", "ethereum", "crypto", "ico", "technology", "defi", "nft", "fintech".

Endpoint -

GET /related_tags/{tag}

Usage -

GET List Info

This endpoint returns the Medium's list-related information - such as id, name, author, description, thumbnail image url, creation datetime, last modified datetime, number of articles in the list, claps, voters, and comments - for the given list_id.

The list_id is the unique hash ID associated with every Medium List. You can see it at the end of the URL as follows:

https:// nishu-jain.medium.com /list/medium-api-38f9e0f9bea6

Here 38f9e0f9bea6 is the list_id.

Endpoint -

GET /list/{list_id}

Usage -

GET List Articles

This endpoint returns an array of article_ids present in the given Medium List.

You can use the GET Article Info endpoint to retrieve information on individual articles.

Endpoint -

GET /list/{list_id}/articles

Usage -

GET List Responses

This endpoint returns an array of response_ids for the given Medium List.

Note: You can treat response_id pretty much same as aritcle_id. To see the content of the response, use the Get Article's Content endpoint.

Endpoint -

GET /list/{list_id}/responses

Usage -

Search Articles

This endpoint returns a list of article_ids 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.

Query Parameter (Required): -

query: A string parameter that specifies the search query for which the articles need to be retrieved.

You can use the GET Article Info endpoint to retrieve information on individual articles.

Endpoint -

GET /search/articles?query={query}

Usage -

Search Publications

This endpoint returns a list of publication_ids 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.

Query Parameter (Required): -

query: A string parameter that specifies the search query for which the publications need to be retrieved.

You can use the GET Publication Info endpoint to retrieve information on individual publications.

Endpoint -

GET /search/publications?query={query}

Usage -

Search Users

This endpoint returns a list of user_ids 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.

Query Parameter (Required): -

query: A string parameter that specifies the search query for which the users need to be retrieved.

You can use the GET User Info endpoint to retrieve information on individual users.

Endpoint -

GET /search/users?query={query}

Usage -

Search Lists

This endpoint returns an array of list_ids 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.

Query Parameter (Required): -

query: A string parameter that specifies the search query for which the Medium Lists need to be retrieved.

You can use the GET List Info endpoint to retrieve information on individual Medium Lists.

Endpoint -

GET /search/lists?query={query}

Usage -

Search Tags

This endpoint returns a list of tags 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.

Query Parameter (Required): -

query: A string parameter that specifies the search query for which the tags need to be retrieved.

Endpoint -

GET /search/tags?query={query}

Usage -

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 pip install medium-api. Visit the following link to know more about Unofficial Medium API's Python SDK.

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!

PS: We post tutorials, videos, code snippets, and insights related to Medium and Unofficial Medium API. So be sure to follow us on:

Twitter: twitter.com/medium_api
LinkedIn: www.linkedin.com/company/medium-api