Medium
App · 4 actions
Follow writers, publications and topics on Medium: list and read their newest stories, and start a workflow when a new one is published.
Actions
| Action | What it does |
|---|---|
| Find stories | Find a source's newest stories whose title, tags or words contain all of some words. |
| Get latest story | Get the newest story from a writer, publication or tag, with its words as plain text. |
| Get writer or publication | Get a writer's, publication's or tag's name, description, picture and link. |
| List stories | List the newest stories from a writer, publication or tag, newest first. |
Find stories
Find a source's newest stories whose title, tags or words contain all of some words.
Inputs
- Writer, publication or tag
sourcetextRequired - A writer as @username, a publication by its name such as towards-data-science, a tag as tag/python, or a link to any of them.
- Words
querytextRequired - Words that must all appear, in any order.
Outputs
countnumber- How many
sourcetext- The source read
storieslist- The stories, newest first
Example output
{
"count": 1,
"source": "acme-engineering",
"stories": [
{
"author": "Ada Lovelace",
"id": "62edea66ffa4",
"image": "https://cdn-images-1.medium.com/max/1024/1*example.png",
"link": "https://medium.com/acme-engineering/how-we-cut-our-build-times-in-half-62edea66ffa4",
"preview": "Our builds took forty minutes. Here is what we changed.",
"published_at": "2026-10-28T09:00:00Z",
"tags": [
"engineering",
"ci"
],
"title": "How we cut our build times in half",
"updated_at": "2026-10-28T09:00:00.000Z"
}
]
}Get latest story
Get the newest story from a writer, publication or tag, with its words as plain text.
Inputs
- Writer, publication or tag
sourcetextRequired - A writer as @username, a publication by its name such as towards-data-science, a tag as tag/python, or a link to any of them.
Outputs
authortext- Who wrote it
idtext- Medium's ID for the story
imagetext- The link to its first picture, if it has one
linktext- A link to it
previewtext- Its first few hundred characters, as plain text
published_attext- When it was published (ISO 8601, UTC)
tagslist- Its tags
texttext- Its words as plain text; some feeds carry only the start
titletext- Its title
updated_attext- When it last changed (ISO 8601)
wordsnumber- How many words the text has
Example output
{
"author": "Ada Lovelace",
"id": "62edea66ffa4",
"image": "https://cdn-images-1.medium.com/max/1024/1*example.png",
"link": "https://medium.com/acme-engineering/how-we-cut-our-build-times-in-half-62edea66ffa4",
"preview": "Our builds took forty minutes. Here is what we changed.",
"published_at": "2026-10-28T09:00:00Z",
"tags": [
"engineering",
"ci"
],
"text": "Our builds took forty minutes...",
"title": "How we cut our build times in half",
"updated_at": "2026-10-28T09:00:00.000Z",
"words": 1260
}Get writer or publication
Get a writer's, publication's or tag's name, description, picture and link.
Inputs
- Writer, publication or tag
sourcetextRequired - A writer as @username, a publication by its name such as towards-data-science, a tag as tag/python, or a link to any of them.
Outputs
descriptiontext- Its description
imagetext- Its picture, if it has one
kindtext- writer, publication or tag
latest_story_attext- When its newest story was published
linktext- A link to it on Medium
nametext- Its name
stories_in_feednumber- How many recent stories its feed holds
Example output
{
"description": "How we build Acme.",
"image": "https://cdn-images-1.medium.com/proxy/1*example.png",
"kind": "publication",
"latest_story_at": "2026-10-28T09:00:00Z",
"link": "https://medium.com/acme-engineering",
"name": "Acme Engineering",
"stories_in_feed": 10
}List stories
List the newest stories from a writer, publication or tag, newest first.
Inputs
- Writer, publication or tag
sourcetextRequired - A writer as @username, a publication by its name such as towards-data-science, a tag as tag/python, or a link to any of them.
- How many
limitnumber - How many stories, up to the ten or so a feed holds. Defaults to 10.From 1 to 25.
Outputs
countnumber- How many
kindtext- writer, publication or tag
sourcetext- The source read
storieslist- The stories, newest first
Example output
{
"count": 1,
"kind": "publication",
"source": "acme-engineering",
"stories": [
{
"author": "Ada Lovelace",
"id": "62edea66ffa4",
"image": "https://cdn-images-1.medium.com/max/1024/1*example.png",
"link": "https://medium.com/acme-engineering/how-we-cut-our-build-times-in-half-62edea66ffa4",
"preview": "Our builds took forty minutes. Here is what we changed.",
"published_at": "2026-10-28T09:00:00Z",
"tags": [
"engineering",
"ci"
],
"title": "How we cut our build times in half",
"updated_at": "2026-10-28T09:00:00.000Z"
}
]
}