# Medium API: List a writer's or publication's latest articles

> Lists the latest public articles by a Medium writer or publication (by username, publication name or Medium link), with dates, reading times, claps, member-only labels and tags.

Unofficial. Not affiliated with or endorsed by Medium.

- Page: https://fous.com/methods/medium.com/list-author-articles
- Method: `medium.com/list_author_articles`, version 1
- Website: medium.com
- Returns: writer or publication name and link; each article's title, subtitle, author, date, reading time, claps, member-only flag, tags, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `author` | string | yes | `"@ev"` | Writer username with or without @, publication name, or Medium profile or publication link. Example: @ev or Towards Data Science. |
| `max_results` | integer | no | `10` | Maximum number of latest articles to return. Example: 10. Default 10. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "author": "@ev",
  "max_results": 10
}
```

Its output:

```json
{
  "link": "https://medium.com/@ev",
  "name": "Ev Williams",
  "articles": [
    {
      "link": "https://ev.medium.com/making-social-social-again-0126fa5c6ce8",
      "tags": [
        "Social",
        "Relationships",
        "Startupş"
      ],
      "claps": 3542,
      "title": "Making “Social” Social Again",
      "author": "Ev Williams",
      "subtitle": "Announcing Mozi",
      "member_only": false,
      "published_date": "2024-12-12",
      "reading_time_minutes": 8
    },
    {
      "link": "https://ev.medium.com/do-not-disturb-3622b4ddc3d8",
      "tags": [],
      "claps": 1782,
      "title": "Do not disturb",
      "author": "Ev Williams",
      "subtitle": "Can I assume when you’re in the zone\nYou’re not distracted by your phone\nShould I hold my texts\nAnd take time to reflect\nOr fire away…",
      "member_only": false,
      "published_date": "2023-12-09",
      "reading_time_minutes": 1
    },
    {
      "link": "https://ev.medium.com/how-you-can-help-the-amazon-rainforest-today-f394d68d4e7",
      "tags": [],
      "claps": 2848,
      "title": "How you can help the Amazon Rainforest–today",
      "author": "Ev Williams",
      "subtitle": "Last week, Brazil’s Congress shocked the world by suddenly fast-tracking and passing PL2903, the Marco Temporal bill. This bill paves the…",
      "member_only": false,
      "published_date": "2023-06-05",
      "reading_time_minutes": 2
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"medium.com/list_author_articles","input":{"author":"@ev","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What has @karpathy posted lately on Medium? Give me the last 8 articles with clap counts and whether they're paywalled.
- Show me the 15 most recent stories from the Towards Data Science publication, including reading times and tags.
- Pull the latest articles from https://medium.com/@barackobama — titles, publish dates and links are enough.
- I'm checking out the writer Cassie Kozyrkov before subscribing. List her 5 newest posts, with claps and which ones are members-only.
- Get the 20 most recent pieces published by Better Programming on medium.com, with subtitles, authors and tags for each.

## Input schema

```json
{
  "type": "object",
  "required": [
    "author"
  ],
  "properties": {
    "author": {
      "type": "string",
      "description": "Writer username with or without @, publication name, or Medium profile or publication link. Example: @ev or Towards Data Science."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum number of latest articles to return. Example: 10."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "link",
    "articles"
  ],
  "properties": {
    "link": {
      "type": "string",
      "description": "Medium writer or publication page link."
    },
    "name": {
      "type": "string",
      "description": "Medium writer or publication name."
    },
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "subtitle",
          "author",
          "published_date",
          "reading_time_minutes",
          "claps",
          "member_only",
          "tags",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "claps": {
            "type": [
              "integer",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "member_only": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "published_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "reading_time_minutes": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "description": "Latest articles, newest first."
    }
  }
}
```

## See more

- [Medium API: List topic articles](https://fous.com/methods/medium.com/list-topic-articles.md): Lists public Medium articles for a topic, newest first or popular this week, with author, publication, reading time, claps and membership status.
- [Medium API: Read an article](https://fous.com/methods/medium.com/read-article.md): Reads a public Medium article from its link, including publication-domain links: details, engagement counts, tags and the plain-text paragraphs. Member-only stories include only the publicly visible preview.
- [Bluesky API: List recent posts](https://fous.com/methods/bsky.app/list-recent-posts.md): Lists an account's latest public Bluesky posts, newest first. Replies and reposts are left out unless requested; a repost's time is when the account reposted it.
- [Threads API: List recent posts](https://fous.com/methods/threads.com/list-recent-posts.md): Lists an account's latest public Threads posts, newest first, with text, engagement counts, thumbnails and links. Only posts shown without logging in are returned.
- [Mastodon API: List recent posts](https://fous.com/methods/mastodon.social/list-recent-posts.md): Lists a Mastodon account's latest public posts, newest first. Replies and boosts are optional. Private and unlisted posts are left out.
- [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.
- [Substack API: List newsletter posts](https://fous.com/methods/substack.com/list-newsletter-posts.md): Finds a Substack newsletter by name or web address and returns its latest public posts with dates, authors, access level and engagement counts.
- [Tumblr API: List blog posts](https://fous.com/methods/tumblr.com/list-blog-posts.md): Lists recent public posts of a Tumblr blog, optionally only those with a given tag. Private or login-only blogs cannot be read.
- [All Medium methods](https://fous.com/methods/medium.com.md)