Find individual episodes by searching for their titles
GET {{baseUrl}}/search_episode_titles?q=<string>&podcast_id=<string>&podcast_id_type=listennotes_id
Conduct targeted searches for individual episodes by title and refine results using the podcast id such as Listen Notes Podcast ID, Apple Podcasts ID, Spotify ID, or RSS feed URL. This endpoint is specially designed to streamline the import of specific episodes from platforms like Apple Podcasts and Spotify into your application. Compared to the GET /search endpoint, which performs full-text searches across multiple fields, this endpoint focuses solely on episode titles for enhanced accuracy and performance.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
q | string | (Required) An episode's title, e.g., Jerusalem Demsas on The Dispossessed. You can use double quotes to do verbatim match, e.g., "Jerusalem Demsas on The Dispossessed". Otherwise, it's fuzzy search. | |
podcast_id | string | Refine search results by specifying a podcast through its unique ID. | |
| The format of the podcast ID is governed by the podcast_id_type parameter. | |||
| For listennotes_id, the podcast ID will look like 'cda18f20f1be4ac7b3cce7d0eb168fff'. | |||
| For itunes_id, it will be a numerical value like '983795625'. | |||
| For spotify_id, expect a format like '0Z1234tGXD2hVhjFrrhJ7g'. | |||
| For rss, the podcast ID will be the RSS URL, e.g., 'https://cowenconvos.libsyn.com/rss'. | |||
podcast_id_type | string | The type of podcast id. Valid values are listennotes_id, itunes_id, spotify_id, and rss. | |
| Note: itunes_id is for Apple Podcasts. | |||
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"next_offset":"\u003cinteger\u003e","took":"\u003cnumber\u003e","total":"\u003cinteger\u003e","count":"\u003cinteger\u003e","results":[{"audio":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","rss":"\u003cstring\u003e","description_highlighted":"\u003cstring\u003e","description_original":"\u003cstring\u003e","title_highlighted":"\u003cstring\u003e","title_original":"\u003cstring\u003e","transcripts_highlighted":["\u003cstring\u003e","\u003cstring\u003e"],"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","pub_date_ms":"\u003cinteger\u003e","id":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","link":"\u003cstring\u003e","podcast":{"id":"\u003cstring\u003e","genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listennotes_url":"\u003cstring\u003e","title_highlighted":"\u003cstring\u003e","title_original":"\u003cstring\u003e","publisher_highlighted":"\u003cstring\u003e","publisher_original":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}},{"audio":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","rss":"\u003cstring\u003e","description_highlighted":"\u003cstring\u003e","description_original":"\u003cstring\u003e","title_highlighted":"\u003cstring\u003e","title_original":"\u003cstring\u003e","transcripts_highlighted":["\u003cstring\u003e","\u003cstring\u003e"],"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","pub_date_ms":"\u003cinteger\u003e","id":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","link":"\u003cstring\u003e","podcast":{"id":"\u003cstring\u003e","genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listennotes_url":"\u003cstring\u003e","title_highlighted":"\u003cstring\u003e","title_original":"\u003cstring\u003e","publisher_highlighted":"\u003cstring\u003e","publisher_original":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}}]}