Search podcasts
search_podcastsRead-only
Search Grep.FM's database of 3M+ podcasts with the same filters as the Grep.FM app: keyword, category, language, activity, publishing rhythm, audience size (ratings, social followers, chart positions), guests and sponsors found in recent episodes (search_by guests or sponsors finds shows by a person or a brand), whether a contact email is on file, and more.
Each show comes with its audience, guest and sponsor signals and has_email; the emails themselves come from get_podcast_contacts. guest_episodes and sponsor_episodes count among analyzed_episodes, the recent episodes AI has read. Link a show by putting its id into podcast_link. Without a keyword or order_by, results follow a quality ranking. grepfm_url opens the same search in the Grep.FM app, where every result can be browsed and exported.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| list | No | Only shows in this list of the user's, by name (see get_lists); the other filters narrow it further. | |
| page | No | Result page; only the first 200 results can be read. | |
| keyword | No | Words to search for. | |
| explicit | No | Whether the show marks itself explicit, useful for brand safety checks. "false" = Clean; "true" = Explicit. | |
| language | No | The language the show's feed declares. 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. "recent" = Recently active first; "most_ratings" = Most Apple ratings first; "oldest" = Oldest shows first; "most_episodes" = Most episodes first; "fewest_episodes" = Fewest episodes first; "longest" = Longest episodes first; "shortest" = Shortest episodes first; "best_apple_rank" = Best Apple rank first; "most_charted" = Most charted first; "most_followers" = Most social followers first. | |
| per_page | No | Results per page, 1 to 50. | |
| sponsors | No | Shows whose recent episodes declared this sponsor. Spelling variants of a brand are merged. | |
| has_email | No | An email was found in the feed (owner email, show description or recurring in episode notes) or on the show's website and link pages. | |
| has_guest | No | AI found a guest in the show's recent episodes. Only active shows are analyzed. | |
| search_by | No | Fields the keyword is matched against. Tick none to search them all. | |
| categories | No | Apple Podcasts categories. A category includes all of its subcategories. | |
| on_youtube | No | The show links a YouTube channel or publishes video in its feed. A few channels belong to the host rather than the show. | |
| keyword_not | No | Hide shows whose title, host or description mentions any of these. | |
| podcast_age | No | Time since the show's first episode. "0-1" = Less than 1 year; "1-3" = 1-3 years; "3-5" = 3-5 years; "5+" = 5+ years. | |
| language_not | No | Exclude these values of language. ISO 639-1 codes such as en, de, es or pt-BR; English names also work. | |
| apple_charted | No | Currently ranked on Apple Podcasts charts. | |
| activity_level | No | Days since the latest episode: Active within 60, Recently Active within 180, Inactive within 365, Dormant beyond that. | |
| categories_not | No | Exclude these values of categories. | |
| guest_frequency | No | Share of the analyzed episodes that had a guest, for shows with at least 3 analyzed. Has Guests needs just one. "50" = Half the episodes or more; "75" = Three in four or more. | |
| spotify_charted | No | Currently ranked on Spotify's podcast charts. | |
| rating_count_max | No | Apple Rating Count, at most. | |
| rating_count_min | No | Apple Rating Count, at least. Number of ratings on Apple Podcasts, the closest public proxy for audience size. | |
| update_frequency | No | How often the show publishes: daily, weekly, monthly and so on. | |
| last_guest_within | No | When the latest episode with a guest came out. "30" = Within 30 days; "90" = Within 90 days. | |
| last_episode_after | No | When the latest episode came out. On or after this date, YYYY-MM-DD. | |
| total_episodes_max | No | Episode Count, at most. | |
| total_episodes_min | No | Episode Count, at least. Episodes currently in the feed. | |
| last_episode_before | No | When the latest episode came out. On or before this date, YYYY-MM-DD. | |
| average_duration_max | No | Avg. Duration (min), at most. | |
| average_duration_min | No | Avg. Duration (min), at least. Average episode length in minutes. | |
| has_declared_sponsor | No | AI found a declared sponsor in the show's recent episodes. Only active shows are analyzed. | |
| social_followers_max | No | Social Followers, at most. | |
| social_followers_min | No | Social Followers, at least. Followers across the show's YouTube, Instagram, Facebook, TikTok and Bluesky accounts. Counted for about half of the shows with guests. | |
| update_frequency_not | No | Exclude these values of update frequency. | |
| youtube_subscribers_max | No | YouTube Subscribers, at most. | |
| youtube_subscribers_min | No | YouTube Subscribers, at least. Subscribers to the show's YouTube channel. |