Substack

Search Substack podcast shows

Search Substack podcast shows.

GET/v1/substack/search/podcasts
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

Text to search podcast shows for.

min 1 chars · max 200 chars

cursorstringoptionalquery

Opaque cursor from the previous page's `nextCursor`.

max 4096 chars

Response fields
25

Endpoint-specific response payload.

datalookupStatus
string

Whether the search ran.

one of: found, not_found

dataquery
string

The query that was searched.

Matching podcast shows.

datashows[]title
stringnullable

The show's title.

datashows[]byline
stringnullable

The show's byline.

datashows[]description
stringnullable

The show's description.

datashows[]artUrl
stringnullable

The show's artwork URL.

datashows[]paidEpisodeArtUrl
stringnullable

Artwork for paid episodes.

datashows[]url
stringnullable

The show's URL.

The publication behind the show.

datashows[]publicationid
integernullable

Numeric publication id.

datashows[]publicationname
stringnullable

The publication's name.

datashows[]publicationsubdomain
stringnullable

The publication's Substack subdomain.

The section the show sits in.

datashows[]sectionid
integernullable

Numeric section id.

datashows[]sectionslug
stringnullable

The section's URL slug.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more pages exist; null on the last page.

dataemptyIsUnverified
boolean

True when the list is empty but it could not be confirmed that the query has no matches.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/substack/search/podcasts?query=climate" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Substack podcast search.