Medium API

Tools (34)

Extracted live via the executor SDK.

• article.getArticleArticleId

  Returns the article related information such as Title, Subtitle, Tags, Topics (assigned by Medium), Publication, Published date and time, Clap Count, Voter Count, Word Count, Reading Time, Language, etc…

• article.getArticleArticleIdContent

  Returns the content of an article/story, for the corresponding article_id

• article.getArticleArticleIdFans

  Returns a list of user_ids of the people who clapped on the article (a.k.a voters).

• article.getArticleArticleIdMarkdown

  Returns the markdown of an article/story from Medium, for the corresponding article_id

• article.getArticleArticleIdRelated

  Returns 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, else related posts will belong to the publication in which the article is published.

• article.getArticleArticleIdResponses

  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" endpoint

• list.getListListId

  Returns the list-related information such as id, name, author, description, thumbnail image url, creation datetime, last article inserted datetime, number of articles in the list, claps, voters, and comments/responses.

• list.getListListIdArticles

  Returns an array of articles_ids present in the given Medium List.

• list.getListListIdResponses

  Returns an array of response_ids of the comments (same as article_ids) on the given Medium List.

• misc.getLatestpostsTopicSlug

  Returns 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
  • relationships
  • mental-health, etc …

  These are known as topic_slugs. At any given moment, this endpoint will return a list of 25 articles (article_ids).

• misc.getRelatedTagsTag

  Returns a list of related_tags for the given tag.

• misc.getTopfeedsTagMode

  Returns a list of article_ids (length: 25) for the given tag and mode.

• misc.getTopWriterTopicSlug

  Returns a list of top writers (user_ids) within a particular topic/niche (topic_slug). e.g.

  • blockchain
  • relationships
  • artificial-intelligence, etc ...

  Note: You can use optional count query parameter to limit the number of results. The maximum number of top writers within a topic/niche will be 250.

• publication.getPublicationIdForPublicationSlug

  Returns the unique publication_id for the given publication_slug.

  Note: You can find the publication_slug from the publication's homepage URL.

  • medium.com/publication_slug
• publication.getPublicationPublicationId

  Returns the publication related information such as Publication name, Tagline, Description, Tags, Followers Count, Twitter username, Instagram username, Facebook Page name, etc …

  Note: If you don't know the publication_id, you can get it from any article published by it. Use endpoint "/article/{article_id}" to retrieve the publication_id.

• publication.getPublicationPublicationIdArticles

  Returns the list of articles_ids, of the latest 25 articles, posted in that publication.

• publication.getPublicationPublicationIdNewsletter

  Returns the newsletter related information such as id, name, description, slug, creator_id, subscribers, image_url, etc …

  Note: If you don't know the publication_id, you can get it from any article published by it. Use endpoint "/article/{article_id}" to retrieve the publication_id.

• search.getSearchArticlesQueryQuery

  Returns the list of articles_ids for the given search query results. (Max Length = 1000)

• search.getSearchListsQueryQuery

  Returns an array of list_ids for the given search query results. (Max Length = 1000)

• search.getSearchPublicationsQueryQuery

  Returns the list of publication_ids for the given search query results. (Max Length = 1000)

• search.getSearchTagsQueryQuery

  Returns a list of tags for the given search query results. (Max Length = 1000)

• search.getSearchUsersQueryQuery

  Returns a list of user_ids for the given search query results. (Max Length = 1000)

• user.getUserIdForUsername

  Returns 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
  • medium.com/@username
• user.getUserUserId

  Returns user related information like Full name, Bio, Followers count, Following count, Twitter username, Profile-image URL, User ID, etc...

  It takes user_id as the path parameter.

  Note: If you don't know the user_id, then you can get it from the endpoint
  '/user/id_for/{username}'.

• user.getUserUserIdArticles

  Returns the list of articles (article_ids) written by the user.

• user.getUserUserIdFollowers

  Returns 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" 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

• user.getUserUserIdFollowing

  Returns 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 following.

• user.getUserUserIdInterests

  Returns a list of tags that the given user follows.

• user.getUserUserIdLists

  Returns 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 "Article Info" endpoint.

• user.getUserUserIdPublications

  Returns a list of publication_ids where the user is the editor and/or creator.

• user.getUserUserIdTopArticles

  Returns a list of article_ids of the top 10 articles on the user's profile, for a given user_id.

• welcome.get

  Test Endpoint Returns the information about the Medium API

• openapi.previewSpec

  Preview an OpenAPI document before adding it as a source

• openapi.addSource

  Add an OpenAPI source and register its operations as tools