Lap-Platform Listen API: Podcast Search, Directory, and Insights API
API version: 2.0
Auth
ApiKey X-ListenAPI-Key in header
Base URL
https://listen-api.listennotes.com/api/v2
Setup
- Set your API key in the appropriate header
- GET /search -- verify access
- POST /episodes -- create first episodes
Endpoints
26 endpoints across 15 groups. See references/api-spec.lap for full details.
search
| Method | Path | Description |
|---|---|---|
| GET | /search | Full-text search |
typeahead
| Method | Path | Description |
|---|---|---|
| GET | /typeahead | Typeahead search |
search_episode_titles
| Method | Path | Description |
|---|---|---|
| GET | /search_episode_titles | Find individual episodes by searching for their titles |
trending_searches
| Method | Path | Description |
|---|---|---|
| GET | /trending_searches | Fetch trending search terms |
related_searches
| Method | Path | Description |
|---|---|---|
| GET | /related_searches | Fetch related search terms |
spellcheck
| Method | Path | Description |
|---|---|---|
| GET | /spellcheck | Spell check on a search term |
best_podcasts
| Method | Path | Description |
|---|---|---|
| GET | /best_podcasts | Fetch a list of best podcasts by genre |
podcasts
| Method | Path | Description |
|---|---|---|
| GET | /podcasts/{id} | Fetch detailed meta data and episodes for a podcast by id |
| DELETE | /podcasts/{id} | Request to delete a podcast |
| POST | /podcasts | Batch fetch basic meta data for podcasts |
| GET | /podcasts/{id}/recommendations | Fetch recommendations for a podcast |
| POST | /podcasts/submit | Submit a podcast to Listen Notes database |
| POST | /podcasts/{id}/rss | Refresh RSS feed of a podcast |
| GET | /podcasts/{id}/audience | Fetch audience demographics for a podcast |
| GET | /podcasts/domains/{domain_name} | Fetch podcasts by a publisher's domain name |
episodes
| Method | Path | Description |
|---|---|---|
| GET | /episodes/{id} | Fetch detailed meta data for an episode by id |
| POST | /episodes | Batch fetch basic meta data for episodes |
| GET | /episodes/{id}/recommendations | Fetch recommendations for an episode |
curated_podcasts
| Method | Path | Description |
|---|---|---|
| GET | /curated_podcasts/{id} | Fetch a curated list of podcasts by id |
| GET | /curated_podcasts | Fetch curated lists of podcasts |
genres
| Method | Path | Description |
|---|---|---|
| GET | /genres | Fetch a list of podcast genres |
regions
| Method | Path | Description |
|---|---|---|
| GET | /regions | Fetch a list of supported countries/regions for best podcasts |
languages
| Method | Path | Description |
|---|---|---|
| GET | /languages | Fetch a list of supported languages for podcasts |
just_listen
| Method | Path | Description |
|---|---|---|
| GET | /just_listen | Fetch a random podcast episode |
playlists
| Method | Path | Description |
|---|---|---|
| GET | /playlists/{id} | Fetch a playlist's info and items (i.e., episodes or podcasts). |
| GET | /playlists | Fetch a list of your playlists. |
Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Search search?" -> GET /search
- "Search typeahead?" -> GET /typeahead
- "Search search_episode_titles?" -> GET /search_episode_titles
- "List all trending_searches?" -> GET /trending_searches
- "Search related_searches?" -> GET /related_searches
- "Search spellcheck?" -> GET /spellcheck
- "List all best_podcasts?" -> GET /best_podcasts
- "Get podcast details?" -> GET /podcasts/{id}
- "Delete a podcast?" -> DELETE /podcasts/{id}
- "Get episode details?" -> GET /episodes/{id}
- "Create a episode?" -> POST /episodes
- "Create a podcast?" -> POST /podcasts
- "Get curated_podcast details?" -> GET /curated_podcasts/{id}
- "List all genres?" -> GET /genres
- "List all regions?" -> GET /regions
- "List all languages?" -> GET /languages
- "List all just_listen?" -> GET /just_listen
- "List all curated_podcasts?" -> GET /curated_podcasts
- "List all recommendations?" -> GET /podcasts/{id}/recommendations
- "List all recommendations?" -> GET /episodes/{id}/recommendations
- "Create a submit?" -> POST /podcasts/submit
- "Create a rss?" -> POST /podcasts/{id}/rss
- "Get playlist details?" -> GET /playlists/{id}
- "List all playlists?" -> GET /playlists
- "List all audience?" -> GET /podcasts/{id}/audience
- "Get domain details?" -> GET /podcasts/domains/{domain_name}
- "How to authenticate?" -> See Auth section
Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object
References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas
Generated from the official API spec by LAP