List Substack publication directory
List Substack publication subdomains, one directory file at a time, cursor paged.
Headers
Get your API keyAPI key (`sfk_...`)
Directory file, 1 to 24. Each file is a numbered slice of the directory, not a category.
≥ 1 · ≤ 24
Page number form, 0 to 100,000; `limit` entries a page. Prefer `cursor` for the next page.
≥ 0 · ≤ 100000
The way to page: pass `page.nextCursor` from the previous response to get the next page. A directory cursor belongs to the file that issued it.
min 1 chars · max 512 chars
Entries to return, 1 to 5,000.
≥ 1 · ≤ 5000
Endpoint-specific response payload.
`found` on success.
one of: found, not_found
The directory file this page came from.
≥ 1 · ≤ 24
The publication subdomains on this page.
The publication's Substack subdomain.
The publication's URL.
The last change the directory reports.
The number of entries in the file.
≥ 0
Offset pagination state for the current page.
Entries skipped on this page.
≥ 0
The page size requested.
≥ 0
True when another page exists.
The way to the next page: pass it as `cursor`; null on the last page.
Offset form: the value to pass as `offset`; null on the last page. Prefer `nextCursor`.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/substack/directory?file=1&limit=5" \
-H "x-api-key: YOUR_API_KEY"Responses
Substack directory.