Does the Listen API: Podcast Search, Directory, and Insights API need an API key?

Yes for the 13 operations checked: an anonymous request was refused, on 2026-09-15. Where the document said nothing about it, this replaces a silence with an observation.

ERR-2026-1723, ERR-2026-1742, ERR-2026-1768, ERR-2026-1819, ERR-2026-1827, ERR-2026-1923, ERR-2026-1924, ERR-2026-1974, ERR-2026-2018, ERR-2026-2159, ERR-2026-2205, ERR-2026-2213

Why is my Listen API: Podcast Search, Directory, and Insights request rejected when I copied the example?

Because the document contradicts itself. 1 parameter in this specification declare one type and give an example, default or allowed value of another. Both statements are in the same file, so this needs no request to confirm.

ERR-2026-2264

Every record behind those answers

14 open records, observed 2026-09-10. Every claim below carries the command that disproves it. If one is wrong, it should be withdrawn — 121 have been across the whole registry.

credentials are required (observed) (13)

The document establishes no authentication requirement for this operation; an anonymous request is refused with 401. The requirement is now observed rather than unknown.

`ERR-2026-1723`	Fetch a random podcast episode	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1742`	Typeahead search	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1768`	Spell check on a search term	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1819`	Fetch a list of supported languages for podcasts	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1827`	Fetch a list of supported countries/regions for best podcasts	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1923`	Find individual episodes by searching for their titles	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1924`	Fetch a list of best podcasts by genre	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-1974`	Fetch a list of your playlists.	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-2018`	Fetch a list of podcast genres	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-2159`	Fetch related search terms	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-2205`	Full-text search	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-2213`	Fetch trending search terms	HTTP 401	checked 2026-09-15, 2 times
`ERR-2026-2234`	Fetch curated lists of podcasts	HTTP 401	checked 2026-09-15, 2 times

Check it yourself:

curl -sS -o /dev/null -w '%{http_code}\n' https://listen-api.listennotes.com/api/v2/just_listen

an example contradicts its own declared type (1)

Parameter 'genre_id' (in query) declares type 'string' and its own example is 93. A caller copying it is refused.

ERR-2026-2264 Fetch a list of best podcasts by genre no runnable check checked 2026-09-15, 2 times

If a record here is wrong

Run its check. If the answer differs from what is written, say so here and it will be withdrawn — 121 already have been. A record nobody can contest is a record asking to be trusted, which is the opposite of the point.

What this page does not tell you

This is not a clean bill of health for anything not listed. The registry was built from a sample of two directories, and an operation absent from it was almost certainly never examined. Silence here means not looked at, not looked at and fine — which is the same mistake this registry exists to record in other people.

What this is

A record of defects in the public description of machine-callable operations: documents a directory claims are live and are not, hosts that no longer resolve, specifications that contradict the API they describe. It is not a ranking, not a review, and not a judgement about the service. No credential is ever sent to anything listed here.

The whole registry, machine-readable: errata.json. Index of subjects: index.html.

Built from registry errata-2026-09-10@b7cb54d3a847. If manifest.json shows a different one, this page is behind the records and should not be trusted over them.