Search episodes
search_episodesRead-only
Search 100M+ podcast episodes by the words in their titles and show notes: brand, product or topic mentions, or a person's appearances. Each result names its show, the guests and sponsors AI found in it and a matching snippet; get_episode reads the full show notes. Unless one_per_podcast is false, a show contributes only its best match. With podcast, lists or searches a single show's episodes. Link a show by putting its id into podcast_link.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page; only the first 200 results can be read. | |
| keyword | No | Words to search for. | |
| podcast | No | Only this show's episodes: a Grep.FM podcast id, or a Grep.FM, Apple Podcasts, Spotify or RSS feed URL. Without a keyword they come newest first. | |
| explicit | No | Whether the feed marks the episode explicit. "false" = Clean; "true" = Explicit. | |
| language | No | The episode's language, which can differ from the show's. ISO 639-1 codes such as en, de, es or pt-BR; English names also work. | |
| order_by | No | Result order; leave out for the default ranking. "-published_at" = Newest first; "published_at" = Oldest first; "-duration" = Longest first; "duration" = Shortest first. | |
| per_page | No | Results per page, 1 to 50. | |
| search_by | No | Fields the keyword is matched against: the episode title, the show notes, or both. "title" = Title; "description" = Description. | |
| match_type | No | Smart match picks phrase or word matching by keyword length. Saved alerts use the same modes. "phrase" = Exact phrase; "all_words" = All words. | |
| keyword_not | No | Hide episodes whose title or show notes mention any of these. | |
| duration_max | No | Duration (min), at most. | |
| duration_min | No | Duration (min), at least. Episode length in minutes. | |
| episode_type | No | Full, bonus or trailer, as the feed marks the episode. | |
| language_not | No | Exclude these values of language. ISO 639-1 codes such as en, de, es or pt-BR; English names also work. | |
| one_per_podcast | No | Collapse the results to each podcast's best match. On by default when browsing, off inside a list. | |
| published_after | No | When the episode came out. On or after this date, YYYY-MM-DD. | |
| episode_type_not | No | Exclude these values of episode type. | |
| published_before | No | When the episode came out. On or before this date, YYYY-MM-DD. |