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
Key | Datatype | Required | Description |
---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"episodes":[{"maybe_audio_invalid":"\u003cboolean\u003e","pub_date_ms":"\u003cinteger\u003e","audio":"\u003cstring\u003e","listennotes_edit_url":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","description":"\u003cstring\u003e","title":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","listennotes_url":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","id":"\u003cstring\u003e","link":"\u003cstring\u003e","podcast":{"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","title":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","publisher":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}},{"maybe_audio_invalid":"\u003cboolean\u003e","pub_date_ms":"\u003cinteger\u003e","audio":"\u003cstring\u003e","listennotes_edit_url":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","description":"\u003cstring\u003e","title":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","listennotes_url":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","id":"\u003cstring\u003e","link":"\u003cstring\u003e","podcast":{"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","title":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","publisher":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}}]}