Datasets

Search Apple Podcasts shows dataset

Searches the crawled public Apple Podcasts show catalog stored in a search index. One row per show. Discovered from a country x genre x collection chart grid and a search-term sweep — not a full catalog of every Apple Podcasts show. Sort enum: relevance, popularity, track_count_desc, release_desc, title_asc. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/apple-podcasts-shows/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/apple-podcasts-shows/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over show title and artist name, max 256 characters

genrestring

Exact primary-genre filter (e.g. Comedy, True Crime), max 128 characters

genre_idstring

Exact Apple Podcasts genre id filter (e.g. 1303 for Comedy), max 128 characters

countrystring

Exact storefront country filter (the crawl's discovery storefront, e.g. us, gb), max 128 characters

explicitnessstring

Exact explicitness filter as reported by Apple (e.g. explicit, cleaned), max 128 characters

run_idstring

Exact crawl run-id filter, max 128 characters

min_track_countinteger

Minimum episode count (track_count), 0 or greater

sort'relevance' | 'popularity' | 'track_count_desc' | 'release_desc' | 'title_asc'

Sort enum: relevance, popularity, track_count_desc, release_desc, title_asc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.