> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/substack/profiles-handle-subscriptions>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/substack/profiles-handle-subscriptions.mdx>

---

# Substack Subscriptions API

The publications a reader shows publicly, one cursor page at a time.

`GET /v1/substack/profiles/{handle}/subscriptions` lists the publications a reader shows publicly. `cursor` comes from the previous page's `page.nextCursor`.

`data.subscriptions[]` carries `id`, `visibility`, `membershipState`, `type`, `isFounding` and a `publication` summary. `data.total` is the count when Substack reports one and null otherwise. `data.profileId` names the reader and `data.page` reports `hasMore` and `nextCursor`. `lookupStatus` is `found` or `not_found`.

## Request

- **Endpoint:** `GET /v1/substack/profiles/{handle}/subscriptions`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/substack/profiles/handle/subscriptions/get)
- **Platform page:** [/platforms/substack](https://www.socialfetch.dev/platforms/substack)

## FAQ

### Are all of a person's subscriptions returned?

Only the ones the person shows publicly. Private subscriptions are not exposed, and the route does not claim to list them.

### Why is total null?

Substack does not always report a count. `total` is null in that case; use the paging fields to know when the list ends.

### How many subscriptions per page?

The route follows Substack's page size and reports `page.hasMore` and `page.nextCursor`. Keep requesting while `hasMore` is true.

### How many credits does a subscriptions page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.