Substack Search API
One query across posts, notes and matching profiles.
GET /v1/substack/search1 credit Failed requests are free
About this endpoint
GET /v1/substack/search?query=... searches across Substack posts, notes and matching profiles. query is required. cursor comes from the previous page's page.nextCursor.
data.items[] uses the shared feed item shape: type, id, post, note, publication, profiles, createdAt and parentComments. Check item.type before reading the nested object. data.page reports hasMore and nextCursor. lookupStatus is found or not_found.
Substack Search API FAQ
What does top search cover?
Posts, notes and a profile block in one feed. Each item says what it is in type, then carries the matching post, note or profiles field.
How do I page top search?
Follow page.nextCursor while page.hasMore is true. The cursor is opaque and tied to the query.
How many credits does a top search 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.
Other Substack endpoints
- PublicationGET /v1/substack/publications/{publication}
- PostsGET /v1/substack/publications/{publication}/posts
- Post bodiesGET /v1/substack/publications/{publication}/posts/bodies
- Post indexGET /v1/substack/publications/{publication}/posts/index
- Search postsGET /v1/substack/publications/{publication}/posts/search
- RecommendationsGET /v1/substack/publications/{publication}/recommendations
- Publication feedGET /v1/substack/publications/{publication}/feed
- PostGET /v1/substack/posts/{post}