> **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/publications-publication-recommendations>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/substack/publications-publication-recommendations.mdx>

---

# Substack Recommendations API

The publications a publication recommends, plus Substack's ordered top list.

`GET /v1/substack/publications/{publication}/recommendations` returns the publications that a publication recommends. `limit` is 1 to 99 and defaults to 50.

`data.recommendations[]` carries `id`, `recommendedPublicationId`, `recommendingPublicationId`, `createdAt`, `blurb` and a `publication` summary. `data.top[]` is Substack's ordered list, with rows of `type` `publication` or `list`, and is null when it was temporarily unavailable. `recommendations` is still served in that case.

## Request

- **Endpoint:** `GET /v1/substack/publications/{publication}/recommendations`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by id, subdomain, host or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/substack/publications/publication/recommendations/get)
- **Platform page:** [/platforms/substack](https://www.socialfetch.dev/platforms/substack)

## FAQ

### What is the difference between recommendations and top?

`recommendations` is the set the publication recommends. `top` is Substack's ordered list, which can include list rows as well as publications.

### Why is top null?

When the ordered list is temporarily unavailable, `top` is null and `recommendations` is still returned rather than failing the whole request.

### How many recommendations can I request?

Between 1 and 99, with 50 as the default.

### How many credits does a recommendations lookup 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.