# Medium API: List topic articles

> Lists public Medium articles for a topic, newest first or popular this week, with author, publication, reading time, claps and membership status.

Unofficial. Not affiliated with or endorsed by Medium.

- Page: https://fous.com/methods/medium.com/list-topic-articles
- Method: `medium.com/list_topic_articles`, version 1
- Website: medium.com
- Returns: title, subtitle, author, publication, published date, reading time, claps, member-only flag, 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 |
|---|---|---|---|---|
| `sort` | string | no | `"latest"` | Article order, for example popular (this week). One of "latest", "popular". Default "latest". |
| `topic` | string | yes | `"artificial intelligence"` | Topic to explore, for example artificial intelligence. |
| `max_results` | integer | no | `10` | Maximum articles to return, for example 10 (up to 25). Default 10. |

## Output

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

```json
{
  "sort": "latest",
  "topic": "artificial intelligence",
  "max_results": 10
}
```

Its output:

```json
{
  "articles": [
    {
      "link": "https://medium.com/@NIDAM_/how-to-use-ai-to-make-9k-each-month-9016df1849a2",
      "claps": 0,
      "title": "How To Use AI To Make $9K Each Month",
      "author": "NIDA M.",
      "subtitle": "There are a feww ways to make AI make you income.",
      "member_only": true,
      "publication": null,
      "published_date": "2026-09-29",
      "reading_time_minutes": 2
    },
    {
      "link": "https://sumanthpoola.medium.com/it-was-2-am-our-payment-service-was-down-the-bug-was-one-line-883152c1b4d2",
      "claps": 0,
      "title": "It Was 2 AM. Our Payment Service Was Down. The Bug Was One Line.",
      "author": "Sumanth | Java & AI",
      "subtitle": "Not one line of bad code. One line of misplaced faith in an annotation.",
      "member_only": true,
      "publication": null,
      "published_date": "2026-09-29",
      "reading_time_minutes": 4
    },
    {
      "link": "https://medium.com/@sudiptokanti/building-health-watcher-an-explainable-ai-system-for-wearable-event-detection-1b30b9b607d4",
      "claps": 0,
      "title": "Building Health-Watcher: An Explainable AI System for Wearable Event Detection",
      "author": "Sudipto K Haldar",
      "subtitle": "How public sensor datasets, subject-level validation, interpretable models, persistence gates, model cards, and an operator-centered…",
      "member_only": false,
      "publication": null,
      "published_date": "2026-09-29",
      "reading_time_minutes": 13
    }
  ]
}
```

## 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_topic_articles","input":{"sort":"latest","topic":"artificial intelligence","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

- Show me the 10 most popular Medium articles this week about machine learning, with claps and reading time
- What are the newest posts on Medium tagged productivity? Give me 15 with author and whether they're member-only
- Find the latest articles on rust programming, include publication name, published date and links
- I need 25 trending pieces this week on startups — titles, subtitles, authors and clap counts
- Pull 5 recent blog articles about mental health and tell me which ones are paywalled and how long they take to read

## Input schema

```json
{
  "type": "object",
  "required": [
    "topic"
  ],
  "properties": {
    "sort": {
      "enum": [
        "latest",
        "popular"
      ],
      "type": "string",
      "default": "latest",
      "description": "Article order, for example popular (this week)."
    },
    "topic": {
      "type": "string",
      "minLength": 1,
      "description": "Topic to explore, for example artificial intelligence."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum articles to return, for example 10 (up to 25)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "articles"
  ],
  "properties": {
    "articles": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "subtitle",
          "author",
          "publication",
          "published_date",
          "reading_time_minutes",
          "claps",
          "member_only",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string"
          },
          "claps": {
            "type": [
              "integer",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "author": {
            "type": [
              "string",
              "null"
            ]
          },
          "subtitle": {
            "type": [
              "string",
              "null"
            ]
          },
          "member_only": {
            "type": "boolean"
          },
          "publication": {
            "type": [
              "string",
              "null"
            ]
          },
          "published_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "reading_time_minutes": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [Medium API: List a writer's or publication's latest articles](https://fous.com/methods/medium.com/list-author-articles.md): 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.
- [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.
- [Substack API: Search newsletters](https://fous.com/methods/substack.com/search-newsletters.md): Finds public Substack newsletters matching a topic, in Substack's search order. Subscriber counts are null when Substack does not display one.
- [ESPN API: List news for a league or team](https://fous.com/methods/espn.com/list-news.md): Finds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first.
- [Britannica API: Get article](https://fous.com/methods/britannica.com/get-article.md): Finds the best-matching Britannica encyclopedia article for a topic and returns its introduction, quick facts, section headings, update date and main image.
- [Snopes API: List latest fact checks](https://fous.com/methods/snopes.com/list-latest-fact-checks.md): Lists the newest Snopes fact checks overall or in a topic, with each claim, rating, author, publication date, image and article link. Topics follow Snopes article categories; less active topics may have fewer recent checks.
- [Reddit API: Search posts](https://fous.com/methods/reddit.com/search-posts.md): Finds public Reddit posts by topic, optionally in one community, for a time window and sort order. Returns up to 100 posts in Reddit search order with score, comment count, text and link.
- [SoundCloud API: List artist tracks](https://fous.com/methods/soundcloud.com/list-artist-tracks.md): Lists a SoundCloud artist's public tracks in latest or SoundCloud popular order, with profile and track details. SoundCloud's popular list may contain fewer than 100 tracks (currently at most 30).
- [All Medium methods](https://fous.com/methods/medium.com.md)