# Medium

> Follow writers, publications and topics on Medium: list and read their newest stories, and start a workflow when a new one is published.

App · 4 actions. Web page: https://docs.lodol.com/docs/integrations/medium

## Actions

### Find stories

Find a source's newest stories whose title, tags or words contain all of some words.

**Inputs**

- Writer, publication or tag (`source`, text, required): 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 (`query`, text, required): Words that must all appear, in any order.

**Outputs**

- `count` (number): How many
- `source` (text): The source read
- `stories` (list): The stories, newest first

**Example output**

```json
{
  "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 (`source`, text, required): 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**

- `author` (text): Who wrote it
- `id` (text): Medium's ID for the story
- `image` (text): The link to its first picture, if it has one
- `link` (text): A link to it
- `preview` (text): Its first few hundred characters, as plain text
- `published_at` (text): When it was published (ISO 8601, UTC)
- `tags` (list): Its tags
- `text` (text): Its words as plain text; some feeds carry only the start
- `title` (text): Its title
- `updated_at` (text): When it last changed (ISO 8601)
- `words` (number): How many words the text has

**Example output**

```json
{
  "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 (`source`, text, required): 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**

- `description` (text): Its description
- `image` (text): Its picture, if it has one
- `kind` (text): writer, publication or tag
- `latest_story_at` (text): When its newest story was published
- `link` (text): A link to it on Medium
- `name` (text): Its name
- `stories_in_feed` (number): How many recent stories its feed holds

**Example output**

```json
{
  "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 (`source`, text, required): 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 (`limit`, number): How many stories, up to the ten or so a feed holds. Defaults to 10. From 1 to 25.

**Outputs**

- `count` (number): How many
- `kind` (text): writer, publication or tag
- `source` (text): The source read
- `stories` (list): The stories, newest first

**Example output**

```json
{
  "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"
    }
  ]
}
```
