Podcast Discovery
GET /podcast-search
Section titled “GET /podcast-search”Search podcasts by name
Proxy search via the configured provider. iTunes (the default when
no PodcastIndex credentials exist) needs no setup; PodcastIndex.org
requires API credentials in settings or environment variables. An
explicit podcastSearchProvider setting always wins. Both providers
return the same result shape; iTunes entries without a feed URL are
dropped.
Parameters
Section titled “Parameters”q(query, string, required): Search query (podcast name or keywords)
Responses
Section titled “Responses”| Status | Description | Body |
|---|---|---|
| 200 | Search results | object |
| 400 | Missing query parameter | |
| 502 | Search provider unreachable | |
| 503 | PodcastIndex selected but credentials not configured |
200 response body
Section titled “200 response body”results(array of object)results[].id(integer)results[].title(string)results[].description(string)results[].artworkUrl(string)results[].feedUrl(string)results[].author(string)results[].link(string)provider(string, one ofitunes,podcastindex): Provider that served this search