Listen Notes API
Listen Notes API
/listennotes/v1/search1 creditSearch Listen Notes for podcasts by keyword. Returns up to 10 matching podcasts with title, publisher, cover image and the podcast id (feed into `podcast` for full details).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | What to look for — a topic, show name or person ('startup', 'true crime', 'Joe Rogan', 'bitcoin'). |
/listennotes/v1/podcast1 creditFull detail for one podcast by id (from search) or a Listen Notes podcast URL: title, publisher, description, cover art, language, country, genres, hosts, rating, total episode count, social links and its latest episodes.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | Podcast id (the short id returned by `search`, e.g. 'ynkdVHl_OTE'). |
| url | optional | — | Alternatively a full Listen Notes podcast URL. |
/listennotes/v1/episode1 creditFull detail for one episode by id or a Listen Notes episode URL: title, description, audio URL, duration, publish date, cover art and the parent podcast.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| id | optional | — | Episode id (32-char uuid, e.g. from a podcast's latest_episodes[].episode_id). |
| url | optional | — | Alternatively a full Listen Notes episode URL. |
/listennotes/v1/best_podcasts1 creditThe curated 'best podcasts' list for a country, paginated. Each entry has the podcast title, publisher, cover image, id, Listen Score and global rank.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| region = us | optional | us · gb · ca · au · de · fr · es · it · nl · se · br · mx · in · jp · kr · cn · tw · hk · sg · ru · tr · za · ph · my · id · th · nz · pt · pl · be | ISO-3166 country code for the curated list (common set listed; others fall back to the global list). |
| page = 1 | optional | 1–20 | Result page (each page is one curated batch). Page until the returned list is empty. |
/listennotes/v1/genre1 creditBrowse the best podcasts in a genre, paginated. Use the `genres` action to get the genre id → name list. Each entry has title, publisher, image, id, Listen Score and global rank.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| genre_id | required | — | Numeric genre id (e.g. 93=Business, 127=Technology, 133=Comedy, 135=True Crime, 134=Music). See `genres`. |
| page = 1 | optional | 1–20 | Result page (each page is one curated batch). Page until the returned list is empty. |
/listennotes/v1/genresfreeThe complete Listen Notes genre taxonomy — every genre id mapped to its name. These ids are the input vocabulary for the `genre` action.
Try in playground →curl -X POST https://api.reefapi.com/listennotes/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"startup"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}