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

# get_substack_posts

> The latest posts of a Substack publication: title, subtitle, link, date, likes, comments and paywall flag. ₹0.12 per call; a result that finds nothing is ₹0.

## What it does

The most recent posts of one Substack publication from its host or URL: data with one row per post carrying the title, subtitle, link, date, author, like and comment counts, whether it sits behind the paywall, and word count, up to limit rows.

Use it to follow a newsletter, to see which of its posts land, or to find writers in a niche; [`read_page`](https://parel.si/docs/tools/read_page.md) reads a free post in full, [`get_medium_posts`](https://parel.si/docs/tools/get_medium_posts.md) is the Medium equivalent, [`read_feed`](https://parel.si/docs/tools/read_feed.md) any other feed. Flat price per call; an unknown publication is free. One to four seconds.

India: Indian newsletters on Substack are growing fast; use the publication's own domain when it has one.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many posts, up to 50. Default 12.; max 50 |
| `publication` | string | yes | The publication's host (name.substack.com or its own domain) or any of its URLs. |

## What drives the cost

Flat per call for up to 50 posts. 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_substack_posts"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_substack_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_substack_posts","input":{"limit":12,"publication":"lennysnewsletter.com"}}'
```

## What comes back

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

```json
[
  {
    "author": "A User 108",
    "comments": 9,
    "date": "2026-11-03T14:45:33.089Z",
    "likes": 335,
    "paywalled": true,
    "subtitle": "100+ gift ideas—all things I actually use, love, and recommend",
    "title": "a public figure’s Newsletter holiday gift guide 2026",
    "url": "https://www.lennysnewsletter.com/p/lennys-newsletter-holiday-gift-guide-057",
    "words": 2759
  },
  {
    "author": "A User 109",
    "comments": 2,
    "date": "2026-10-13T12:45:41.160Z",
    "likes": 387,
    "paywalled": true,
    "subtitle": "A framework for assessing whether the company you’re considering joining is built to last",
    "title": "How to tell if a startup has a moat ",
    "url": "https://www.lennysnewsletter.com/p/how-to-tell-if-a-startup-has-a-moat",
    "words": 4153
  },
  {
    "author": "A User 108",
    "comments": 9,
    "date": "2026-09-29T13:15:57.512Z",
    "likes": 294,
    "paywalled": false,
    "subtitle": "Plus, some reflections and takeaways from the day",
    "title": "All of the a public figure & Friends Summit talks are now online!",
    "url": "https://www.lennysnewsletter.com/p/all-of-the-lenny-and-friends-summit",
    "words": 1276
  }
]
```

## Notes

- Flat per call for up to 50 posts.
- The paywalled flag tells you whether read_page will get the full text.
- Pairs with read_page.

## Siblings

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