Batch fetch basic meta data for episodes

POST {{baseUrl}}/episodes

Batch fetch basic meta data for up to 10 episodes. This endpoint could be used to implement custom playlists for individual episodes. For detailed meta data of an individual episode, you need to use GET /episodes/{id}. This endpoint is available only in the PRO/ENTERPRISE plan.

Request Body

[{"name"=>"ids", "value"=>"<string>", "datatype"=>"string"}]

HEADERS

KeyDatatypeRequiredDescription
X-ListenAPI-Keystring(Required) Get API Key on listennotes.com/api
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;episodes&quot;:[{&quot;maybe_audio_invalid&quot;:&quot;\u003cboolean\u003e&quot;,&quot;pub_date_ms&quot;:&quot;\u003cinteger\u003e&quot;,&quot;audio&quot;:&quot;\u003cstring\u003e&quot;,&quot;listennotes_edit_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;explicit_content&quot;:&quot;\u003cboolean\u003e&quot;,&quot;listennotes_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;audio_length_sec&quot;:&quot;\u003cinteger\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;link&quot;:&quot;\u003cstring\u003e&quot;,&quot;podcast&quot;:{&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;listennotes_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;publisher&quot;:&quot;\u003cstring\u003e&quot;,&quot;listen_score&quot;:&quot;\u003cinteger\u003e&quot;,&quot;listen_score_global_rank&quot;:&quot;\u003cstring\u003e&quot;}},{&quot;maybe_audio_invalid&quot;:&quot;\u003cboolean\u003e&quot;,&quot;pub_date_ms&quot;:&quot;\u003cinteger\u003e&quot;,&quot;audio&quot;:&quot;\u003cstring\u003e&quot;,&quot;listennotes_edit_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;explicit_content&quot;:&quot;\u003cboolean\u003e&quot;,&quot;listennotes_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;audio_length_sec&quot;:&quot;\u003cinteger\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;link&quot;:&quot;\u003cstring\u003e&quot;,&quot;podcast&quot;:{&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;listennotes_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;publisher&quot;:&quot;\u003cstring\u003e&quot;,&quot;listen_score&quot;:&quot;\u003cinteger\u003e&quot;,&quot;listen_score_global_rank&quot;:&quot;\u003cstring\u003e&quot;}}]}