> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_medium_posts

# get_medium_posts

> The latest Medium posts for a tag, author or publication: title, link, author, date and summary. ₹0.12 per call; a result that finds nothing is ₹0.

## What it does

The most recent posts on Medium for one tag, one author or one publication: data with one row per post carrying the title, link, author, publication time, categories and the first 300 characters of the summary; Medium's feed carries about ten items, so that is the most a call returns.

Use it to follow what is being written on a topic or by a voice you track; [`read_page`](https://parel.si/docs/tools/read_page.md) reads a post in full, [`get_substack_posts`](https://parel.si/docs/tools/get_substack_posts.md) does the same for Substack, [`read_feed`](https://parel.si/docs/tools/read_feed.md) for any other feed. Flat price per call; an unknown tag, author or publication is free. One to three seconds.

India: Indian writers and publications are well represented on Medium; try the tag india or startups.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `tag` | string | one of | A Medium tag slug ("startup"). Wins when several are set. |
| `limit` | integer | no | How many posts, up to 10. Default 10.; max 10 |
| `author` | string | one of | A Medium username, without the @. |
| `publication` | string | one of | A publication slug. |

One of these sets must be complete (anything else is `invalid_input`, ₹0): `tag`; `author`; `publication`.

## What drives the cost

Flat per call; about ten posts, the size of Medium's feed. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.12** per call (`cost_paise: 12`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_medium_posts"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_medium_posts"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_medium_posts","input":{"tag":"startup"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
[
  {
    "author": "A User 105",
    "categories": "business-strategy, business, fintech, startup, startup-life",
    "published": "Thu, 05 Nov 2026 14:46:55 GMT",
    "summary": "A restaurant owner in Tampa opens an envelope marked “FINAL NOTICE.” It says her LLC must file a beneficial ownership report within ten…",
    "title": "BOI Reporting Is Over for U.S. LLCs. Here’s What Actually Changed.",
    "url": "https://medium.com/@admin_51009/boi-reporting-is-over-for-u-s-llcs-heres-what-actually-changed-372ba0938144"
  },
  {
    "author": "A User 106",
    "categories": "entrepreneurship, money, business, ai, startup",
    "published": "Thu, 05 Nov 2026 14:41:51 GMT",
    "summary": "The AI boom has sparked a modern-day trademark land rush. Every week, new companies launch AI-powered platforms, assistants, copilots…",
    "title": "Trademark Risks for AI Startups: Avoid Costly Naming Mistakes",
    "url": "https://medium.com/@trentice.bolar/trademark-risks-for-ai-startups-avoid-costly-naming-mistakes-a28a1fc1c4fd"
  },
  {
    "author": "A User 107",
    "categories": "productivity, artificial-intelligence, technology, careers, startup",
    "published": "Thu, 05 Nov 2026 14:29:06 GMT",
    "summary": "The story of Kian Mercer and his vision for an AI-powered career platform.",
    "title": "What Is Adin AI? Building a Free AI Career Assistant in Pakistan",
    "url": "https://medium.com/@kiansovereign/what-is-adin-ai-building-a-free-ai-career-assistant-in-pakistan-345040a071e4"
  }
]
```

## Notes

- Flat per call; about ten posts, the size of Medium's feed.
- Set one of tag, author or publication; tag wins when several are set.
- Pairs with read_page for the full text.

## Siblings

- [`read_page`](https://parel.si/docs/tools/read_page.md)
- [`get_substack_posts`](https://parel.si/docs/tools/get_substack_posts.md)
- [`read_feed`](https://parel.si/docs/tools/read_feed.md)
