ImagePodcast APIby Listen Notes

API v2 Search · Directory · Insights

Podcast API by Listen Notes

Search podcasts and episodes, retrieve structured metadata, build recommendations and charts, and access available transcripts and audience insights through one REST API.

Get API keys
Read the docs
listennotes.com/api

$ curl -G \

-H "X-ListenAPI-Key: $LISTEN_API_KEY" \

"https://listen-api.listennotes.com/api/v2/search" \

--data-urlencode "q=startup" \

--data-urlencode "type=podcast"

Llamacorn mascot enthusiastically presenting an API connection

Built and operated by Listen Notes since 2017.

API workflowsStart with the task

Common API workflows

What can you build with the Podcast API?

Start with the user task, then verify the exact request and response contract in the live OpenAPI document.

Get API keys

Real-world products

  • 01

    Podcast player apps

    Build full-featured listening experiences with search, metadata, artwork, audio, and discovery.

  • 02

    Media monitoring

    Track people, brands, companies, and topics mentioned across podcast episodes.

  • 03

    Financial intelligence

    Surface podcast discussions about companies, executives, industries, and market-moving topics.

  • 04

    Education platforms

    Search, curate, and stream relevant podcasts and episodes for courses and research.

  • 05

    Podcast clipping apps

    Use returned audio URLs with your media workflow to create bounded, shareable clips.

  • 06

    Media social networks

    Let people discover and share podcasts, episodes, clips, and curated playlists.

API building blocks

  1. 01

    Search and autocomplete

    Build full-text search, episode-title lookup, query suggestions, spellcheck, and related-search flows.

    GET /searchGET /typeaheadGET /search_episode_titles
  2. 02

    Podcast and episode metadata

    Fetch one item or hydrate bounded batches of known podcast and episode identifiers.

    GET /podcasts/{id}GET /episodes/{id}POST /podcasts
  3. 03

    Recommendations and discovery

    Power similar-show recommendations, charts by genre or region, and serendipitous listening.

    GET /podcasts/{id}/recommendationsGET /best_podcastsGET /just_listen
  4. 04

    Transcripts and media

    For episodes with transcripts, retrieve them directly from the episode endpoint. When a transcript is unavailable, use the returned audio URL with a third-party speech-to-text API to generate one.

    GET /episodes/{id}?show_transcript=1
  5. 05

    Audience and publisher insights

    Retrieve available regional audience data or find podcasts associated with a publisher domain.

    GET /podcasts/{id}/audienceGET /podcasts/domains/{domain_name}
  6. 06

    Playlists and podcaster workflows

    Read Listen Later playlists, submit new feeds, request RSS refreshes, and manage removal workflows.

    GET /playlists/{id}POST /podcasts/submitPOST /podcasts/{id}/rss

Podcast API fact sheet

Built for the long run.

Stable infrastructure, broad public-podcast coverage, and active quality control from Listen Notes.

Get API keys
01Service provider
Listen Notes, Inc.

The company that builds and operates PodcastAPI.com and the Listen Notes podcast search engine.

Visit Listen Notes
02Available since
December 2017

The first version of the Podcast API launched with search, podcast, and episode endpoints.

Read the launch note
03Powered products
13,000+

Apps and websites powered by the API, trusted by companies and developers around the world.

See current API figures
04Public podcast coverage
3.8M+ podcasts / 190M+ episodes

A broad index of publicly accessible podcasts and episodes, continuously discovered and refreshed.

See the live catalog count
05Database quality
Genuine, human-created shows

Automated detection and human moderation remove AI-generated junk, fake shows, and spammy podcasts.

How Listen Notes fights spam

Podcast API quickstart

One request.
Server-side key.

Store your production key in LISTEN_API_KEY and send it from a trusted backend. Never expose it in browser code, mobile binaries, URLs, logs, or source control.

Productionhttps://listen-api.listennotes.com/api/v2

Mock testinghttps://listen-api-test.listennotes.com/api/v2

The mock API uses fixed fake data and is only for transport and response-shape tests.

Read the docs OpenAPI YAML
Get API keys
cURL
$ curl -G \
  -H "X-ListenAPI-Key: $LISTEN_API_KEY" \
  "https://listen-api.listennotes.com/api/v2/search" \
  --data-urlencode "q=climate technology" \
  --data-urlencode "type=podcast"

PodcastAPI / Agent Skill

Teach your coding agent the API.

Install our open-source skill for secure credentials, endpoint selection, pagination, mock-server testing, and current documentation.

Explore PodcastAPI/skills
Get API keys
Install paths

Skills CLI

$npx skills add PodcastAPI/skills

OpenAI Codex

From Codex, use the built-in skill installer and ask it to install this repository's podcast-api skill:

$skill-installer
Install the podcast-api skill from https://github.com/PodcastAPI/skills/tree/main/skills/podcast-api

Claude Code Plugin

$/plugin marketplace add podcastapi/skills
$/plugin install podcast-api@podcastapi

Live demo

Start from a working demo.

Try the hosted Podcast API demo, inspect the source, or deploy your own copy to Cloudflare Workers from the same GitHub repository.

Get API keys
Hosted demodemo.podcastapi.comGitHub sourceListenNotes/demo.podcastapi.comOne-click deployDeploy to Cloudflare

Official clients

Your language.
Our SDK.

Start with a maintained client, or call the REST API directly from any server-side stack.

Get API keys

Developer FAQ

Answers before your first request.

For pricing, quotas, plan availability, and policy details, use the current documentation and terms.

API documentation API terms
Get API keys
01What is the Listen Notes Podcast API?
It is a REST API for server-side applications and agents that need podcast and episode search, structured metadata, discovery, playlists, and audience insights.
02What podcast data can I retrieve?
Responses can include podcast and episode identifiers, titles, publishers, descriptions, artwork, dates, languages, countries, popularity signals, external links, and other endpoint-specific fields. Availability varies by endpoint and plan.
03How do I authenticate production requests?
Store the key in a server-side environment variable such as LISTEN_API_KEY and send its value in the X-ListenAPI-Key request header.
04Can I call the API directly from a browser or mobile app?
Do not expose a production key in browser code or a distributed mobile binary. Send credentialed requests through a trusted backend or serverless function.
05Can I test without an API key?
Yes. The mock base URL returns fixed fake data without a key for transport and response-shape tests. It does not validate search relevance, filters, pagination, plan behavior, or freshness.
06Are podcast transcripts available?
When Listen Notes has a transcript for the episode, you can request it with GET /episodes/{id}?show_transcript=1. When a transcript is unavailable, use the episode audio URL returned by the API with a third-party speech-to-text service to generate one. Direct transcript access depends on the current plan, so check the live documentation before building around it.
07How much does the Podcast API cost?
You can start with the FREE plan and optionally upgrade to the paid PRO or Enterprise plan.Learn more about pricing

Built for people and agents

The whole API,
in two plain-text files.

The concise index points agents to canonical resources. The complete reference is generated from the live OpenAPI contract and official integration guidance.

Get API keys
Quick indexllms.txtComplete referencellms-full.txt

Ready to build?

Find the signal
in every podcast.

Get API keys