Search a channel's published episodes
Hybrid (semantic + keyword) search over a channel's published episodes and transcripts. Returns ranked episodes with best-matching, timestamped segments; each segment carries a deep link to the exact moment. An empty result is 200 with an empty episodes array, never a 404.
Path Parameters
The channel's slug (its subdomain on podhood.com).
Query Parameters
The natural-language search query (alias: q). Missing or empty yields an empty result set, not an error.
true skips the semantic leg for a cheaper keyword-only search.
Filter to these topic ids.
Filter to episodes featuring these person entity ids (hosts and guests).
Filter to episodes mentioning these company/product entity ids.
Scope to these episode ids (e.g. to search within a prior result set).
Filter to one collection (mirrored playlist).
Filter to a publication year.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/channels/string/search"{ "query": "string", "episodes": [ { "episodeId": "string", "title": "string", "url": "string", "score": 0, "matchedVia": [ "string" ], "segments": [ { "segmentId": "string", "text": "string", "startMs": 0, "endMs": 0, "speaker": "string", "url": "string", "deepLink": "string", "matchedVia": [ "string" ] } ], "summary": "string", "publishedAt": "string", "durationMs": 0 } ]}{ "error": "string"}