# Substack API

Read recent posts from a newsletter.

Give your agent a publication URL and get post metadata. One Astral Codex Ten request returned three public posts with titles, dates and engagement counts.

One publication snapshot of free post metadata. Engagement counts can change.

Provider in the worked example: AnyAPI.

Price shown for this route: 0.931¢ for the tested request.

## Choose how to read public Substack posts.

The publication feed and the paid API both supplied the three recent post links in our test.

Prices and access checked on 13 November 2026.

| Option | Price and billing | Strength | Good to know | Access |
| --- | --- | --- | --- | --- |
| AnyAPI (Through TaskFuel) | $0.00931. Tested request from your TaskFuel balance. Astral Codex Ten · three free posts · metadata only | Structured JSON with publication timestamps and engagement counts. | One publication snapshot of free post metadata. Engagement counts can change. | TaskFuel |
| Substack RSS (Public publication feed) | $0. Public RSS feed. Read the publication’s /feed URL. | Titles, dates and links for recent posts. | The tested feed omitted reaction and comment counts. | Direct |

- [AnyAPI: provider reference](https://getanyapi.com/api/substack/posts). Checked 2026-11-13.
- [Substack RSS: provider reference](https://support.substack.com/hc/en-us/articles/360038239391-Is-there-an-RSS-feed-for-my-publication). Checked 2026-11-13.


## What it can do

### Read public publication posts

Pass a publication URL and a result limit. Our metadata-only request returned post links, publication timestamps, reaction counts and comment counts.

Price: $0.00931 for the tested request.


## A real example

Tested on 2026-11-13 through AnyAPI.

The three titles and timestamps matched the first three entries in the public RSS feed. AnyAPI also returned reactions, comments and restacks for each post.

Your agent asked: Find three recent free posts from Astral Codex Ten. Return each title, date, link and the reported reaction and comment counts.

Returned in this test:

- 12 Nov 2026 UTC: [AI Company Employees Should Unionize · 59 reactions · 9 comments](https://www.astralcodexten.com/p/ai-company-employees-should-unionize)
- 11 Nov 2026 UTC: [Escaping The “Outside Criticism” Trap · 319 reactions · 318 comments](https://www.astralcodexten.com/p/escaping-the-outside-criticism-trap)
- 9 Nov 2026 UTC: [Open Thread 459 · 41 reactions · 451 comments](https://www.astralcodexten.com/p/open-thread-459)

Charged in this test: $0.00931.

One publication snapshot of free post metadata. Engagement counts can change.




## Try the API request

Use your TaskFuel API key as TASKFUEL_API_KEY in your terminal or server. Keep it out of browser code.

### 1. Check the price

This request checks the price without paying. This is the exact request used in the dated example.

```sh
curl --fail-with-body https://app.taskfuel.ai/v1/call \
  -H "Authorization: Bearer $TASKFUEL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'TASKFUEL_REQUEST'
{
  "url": "https://api.getanyapi.com/v1/run/substack.posts",
  "method": "POST",
  "body": {
    "url": "https://www.astralcodexten.com",
    "limit": 3,
    "onlyFree": true,
    "includeContent": false,
    "includeComments": false
  },
  "dryRun": true
}
TASKFUEL_REQUEST
```

### 2. Run the request

Review amount_usd in the quote. To pay and run, change dryRun to false and add maxAmountUsd with that approved amount inside the same JSON object. Keep the inputs unchanged; this limit applies to one call.

### 3. Read the result

Read output.data.items[].title, url, createdUtc, reactionCount and commentCount. createdUtc is a Unix timestamp in seconds. The test requested free posts with content and comment threads disabled.



[Setup and API reference](https://taskfuel.ai/docs/) · [Job polling and timeout recovery](https://app.taskfuel.ai/using.md)


## Connect your agent

Read the [setup guide](https://taskfuel.ai/docs/setup/) and choose the connection your agent supports.

Use one TaskFuel account and prepaid balance. Inspect the provider and request quote before a paid call, then review the returned response and recorded charge.



## When to use it

### Put three posts in a brief.

Your agent can turn the returned titles, dates and source links into a short reading list.

### Add discussion counts to a reading list.

The metadata response includes comment and reaction counts for comparing posts from the same publication.




## Questions

### Does Substack have an official API?

Substack documents API terms for certain public creator and publication information. This example uses AnyAPI for public post metadata.

### When is RSS enough?

The public feed supplied the same titles, timestamps and links for these three posts. AnyAPI added structured reaction, comment and restack counts.

### Does this request publish posts or retrieve paid articles?

The example reads metadata for free posts from a public publication. Publishing and subscriber access are handled in Substack.

### What did the example cost?

The example cost $0.00931 on 13 November 2026. Your agent shows the price for your own request before it pays.

### Do I need a separate provider account?

A TaskFuel connection is enough. Your agent pays from your TaskFuel balance.

## Related tool guides

- [Read a public article as Markdown](https://taskfuel.ai/tools/extract-webpage/)
- [Inspect the metadata for a post URL](https://taskfuel.ai/tools/url-metadata/)


## Reference

- [Read this guide on the website](https://taskfuel.ai/tools/substack-api/).
- [Browse providers and capabilities](https://taskfuel.ai/catalog/).
- [Pricing](https://taskfuel.ai/pricing/).
- [Agent instructions](https://taskfuel.ai/llms.txt).
