Podcast API Tutorials - How to build a podcast app using Listen API?
API VERSION: V2 ·
PodcastAPI.com
Get started:
- Get your API keys (or API tokens) or use API mock server without API keys.
- Add coworkers to your team. They'll login with their own accounts and see API keys.
- Check out these open source projects using Listen API on GitHub: 1) Cloudflare Workers; 2) Kotlin and Jetpack Compose; 3) Django and ReactJs.
- Install the podcast-api skill to help your coding agent, such as OpenAI Codex or Claude Code, use our Podcast API more effectively.
- You can use your favorite http libraries to directly send REST requests, or use our official libraries:
Read from https://www.podcastapi.com/llms-full.txt so I can ask questions about the Podcast API from Listen Notes.
Questions?
hello@listennotes.com
0. Do you provide a mock API server for Listen Notes Podcast API?
Yes, you can try out our podcast API without api keys.
Read detailed tutorial
1. How to get latest (or all) episodes of a podcast?
Use GET /podcasts/{id} or POST /podcasts.
Read detailed tutorial
2. How to implement "import OPML" and "export OPML" in a podcast app?
Use POST /podcasts.
Read detailed tutorial
3. How to build a playlist for episodes in a podcast app?
Use POST /episodes or GET /playlists/{id}.
Read detailed tutorial
4. How to fetch new episodes for subscribed podcasts using podcast api?
Use POST /podcasts and GET /podcasts/{id}.
Read detailed tutorial
5. How to search episodes for specific podcasts using podcast api?
Use GET /search with the "ocid" parameter (for the podcast id).
Read detailed tutorial
6. How to fetch metadata (e.g., rss, episodes...) of podcasts by Apple Podcasts ids (iTunes ids) or Spotify ids?
POST /podcasts with the "itunes_ids" / "spotify_ids" parameter.
Read detailed tutorial
7. How to check how many requests I've used in this billing cycle?
Check the X-ListenAPI-Usage header in the response.
Read detailed tutorial
8. How to have multiple API tokens without creating multiple accounts?
Go to the APPS tab of your API Dashboard.
Read detailed tutorial
9. How to get sub-genres for a particular podcast genre?
Use GET /genres and the parent_id data field.
Read detailed tutorial
10. How to get more accurate search results when searching podcast names?
Search only the podcast name & publisher name. Use double quotes.
Read detailed tutorial
11. How to get podcast / episode / playlist ids on Listen Notes?
"Use API to fetch this..." link.
Read detailed tutorial
12. How to use webhooks of podcast api?
Go to the "WEBHOOKS" tab in your API Dashboard.
Read detailed tutorial
13. How to create audio or video clips for a specific podcast episode?
Download the audio and use tools like FFmpeg.
Read detailed tutorial
14. What's the easiest way for our human content curators to handpick specific podcasts/episodes into our app using podcast api?
Use Listen Later playlists.
Read detailed tutorial
15. How to get transcripts of any podcast episodes using podcast api?
Pass the "show_transcript=1" parameter to GET /episodes/{id} or transcribe on your own.
Read detailed tutorial
16. How to use various podcast search endpoints?
GET /trending_searches, GET /typeahead, GET /search, GET /related_searches...
Read detailed tutorial
17. Do you provide a pre-built embedded podcast player that I can put on my website?
Append "embed/" to "listennotes_url".
Read detailed tutorial
18. How to get popular podcasts by country / category?
Use GET /best_podcasts with sort=listen_score.
Read detailed tutorial
