Batch fetch basic meta data for podcasts

POST {{baseUrl}}/podcasts

Batch fetch basic meta data for up to 10 podcasts. This endpoint could be used to build something like OPML import, allowing users to import a bunch of podcasts via rss urls. For detailed meta data (including episodes) of an individual podcast, you need to use GET /podcasts/{id}. This endpoint is available only in the PRO/ENTERPRISE plan.

Request Body

[{"name"=>"ids", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"rsses", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"itunes_ids", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"spotify_ids", "value"=>"<string>", "datatype"=>"string"}, {"name"=>"show_latest_episodes", "value"=>"0", "datatype"=>"number"}, {"name"=>"next_episode_pub_date", "value"=>"<integer>", "datatype"=>"string"}]

HEADERS

RESPONSES

status: OK

{"podcasts":[{"is_claimed":"\u003cboolean\u003e","type":"episodic","explicit_content":"\u003cboolean\u003e","website":"\u003cstring\u003e","total_episodes":"\u003cinteger\u003e","audio_length_sec":"\u003cinteger\u003e","update_frequency_hours":"\u003cinteger\u003e","earliest_pub_date_ms":"\u003cinteger\u003e","rss":"\u003cstring\u003e","latest_episode_id":"\u003cstring\u003e","latest_pub_date_ms":"\u003cinteger\u003e","title":"\u003cstring\u003e","language":"\u003cstring\u003e","description":"\u003cstring\u003e","email":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","country":"\u003cstring\u003e","publisher":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","looking_for":{"cohosts":"\u003cboolean\u003e","cross_promotion":"\u003cboolean\u003e","sponsors":"\u003cboolean\u003e","guests":"\u003cboolean\u003e"},"extra":{"youtube_url":"\u003cstring\u003e","facebook_handle":"\u003cstring\u003e","instagram_handle":"\u003cstring\u003e","twitter_handle":"\u003cstring\u003e","wechat_handle":"\u003cstring\u003e","patreon_handle":"\u003cstring\u003e","google_url":"\u003cstring\u003e","amazon_music_url":"\u003cstring\u003e","linkedin_url":"\u003cstring\u003e","spotify_url":"\u003cstring\u003e","url1":"\u003cstring\u003e","url2":"\u003cstring\u003e","url3":"\u003cstring\u003e"},"genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"},{"is_claimed":"\u003cboolean\u003e","type":"episodic","explicit_content":"\u003cboolean\u003e","website":"\u003cstring\u003e","total_episodes":"\u003cinteger\u003e","audio_length_sec":"\u003cinteger\u003e","update_frequency_hours":"\u003cinteger\u003e","earliest_pub_date_ms":"\u003cinteger\u003e","rss":"\u003cstring\u003e","latest_episode_id":"\u003cstring\u003e","latest_pub_date_ms":"\u003cinteger\u003e","title":"\u003cstring\u003e","language":"\u003cstring\u003e","description":"\u003cstring\u003e","email":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","country":"\u003cstring\u003e","publisher":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","looking_for":{"cohosts":"\u003cboolean\u003e","cross_promotion":"\u003cboolean\u003e","sponsors":"\u003cboolean\u003e","guests":"\u003cboolean\u003e"},"extra":{"youtube_url":"\u003cstring\u003e","facebook_handle":"\u003cstring\u003e","instagram_handle":"\u003cstring\u003e","twitter_handle":"\u003cstring\u003e","wechat_handle":"\u003cstring\u003e","patreon_handle":"\u003cstring\u003e","google_url":"\u003cstring\u003e","amazon_music_url":"\u003cstring\u003e","linkedin_url":"\u003cstring\u003e","spotify_url":"\u003cstring\u003e","url1":"\u003cstring\u003e","url2":"\u003cstring\u003e","url3":"\u003cstring\u003e"},"genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"}],"latest_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"}}]}