actionGETv1.0.0
Get Article Fans
Returns a list of `user_ids` of the people who clapped on the article (a.k.a `voters`).
actionGETv1.0.0
Get Article Info
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…*
actionGETv1.0.0
Get Article Responses
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
actionGETv1.0.0
Get Article's Content
Returns the content of an article/story, for the corresponding `article_id`
actionGETv1.0.0
Get Article's Markdown
Returns the markdown of an article/story from Medium, for the corresponding `article_id`
actionGETv1.0.0
Get Latest Posts
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`).
actionGETv1.0.0
Get List Articles
Returns an array of `articles_ids` present in the given Medium List.
actionGETv1.0.0
Get List Info
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*.
actionGETv1.0.0
Get List Responses
Returns an array of `response_ids` of the comments (same as `article_ids`) on the given Medium List.
actionGETv1.0.0
Get Publication Articles
Returns the list of `articles_ids`, of the latest 25 articles, posted in that publication.
actionGETv1.0.0
Get Publication ID
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**
actionGETv1.0.0
Get Publication Info
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`.
actionGETv1.0.0
Get Publication Newsletter
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`.
actionGETv1.0.0
Get Related Articles
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.
actionGETv1.0.0
Get Related Tags
Returns a list of `related_tags` for the given `tag`.
actionGETv1.0.0
Get Top Writers
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.
actionGETv1.0.0
Get Topfeeds
Returns a list of `article_ids` (length: 25) for the given `tag` and `mode`.
actionGETv1.0.0
Get User Followers
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
actionGETv1.0.0
Get User Following
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.
actionGETv1.0.0
Get User ID
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**
actionGETv1.0.0
Get User Info
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`}'.
actionGETv1.0.0
Get User's Articles
Returns the list of articles (`article_ids`) written by the user.
actionGETv1.0.0
Get User's Interests
Returns a list of tags that the given user follows.
actionGETv1.0.0
Get User's Lists
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.
actionGETv1.0.0
Get User's Publications
Returns a list of `publication_ids` where the user is the editor and/or creator.
actionGETv1.0.0
Get User's Top Articles
Returns a list of `article_ids` of the top 10 articles on the user's profile, for a given `user_id`.
actionGETv1.0.0
Get Welcome
**Test Endpoint** Returns the information about the Medium API
actionGETv1.0.0
Search Articles
Returns the list of `articles_ids` for the given search query results. (Max Length = 1000)
actionGETv1.0.0
Search Lists
Returns an array of `list_ids` for the given search query results. (Max Length = 1000)
actionGETv1.0.0
Search Publications
Returns the list of `publication_ids` for the given search query results. (Max Length = 1000)
actionGETv1.0.0
Search Tags
Returns a list of `tags` for the given search query results. (Max Length = 1000)
actionGETv1.0.0
Search Users
Returns a list of `user_ids` for the given search query results. (Max Length = 1000)
Beyond the catalog
Any provider, on request.
01
Request it
Tell us which provider you need, and we will ship it in the registry.
02
Generate it
Point swirls add at an OpenAPI or GraphQL spec. Typed actions for any API you hold credentials for, today.
acme · integrations
terminal
~/acme $swirls add linear
✓ 12 typed actions · scopes and schemas included
~/acme $swirls add https://api.acme.dev/openapi.json
◆ Fetched spec · 38 operations
✓ 6 typed actions · generated from spec