Search Podcasts

POST https://api.podengine.ai/api/v1/search/podcasts

Search for podcasts by title, description, or RSS feed URL

Example request

curl -X POST "https://api.podengine.ai/api/v1/search/podcasts" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN" \
  -d '{
  "searchTerms": [
    {
      "searchTargets": [
        "podcast-title",
        "podcast-title"
      ],
      "searchTerm": "podcast creation",
      "searchType": "text",
      "searchTermOptions": {
        "matchMode": "must",
        "phraseMatch": true,
        "slop": 1
      }
    }
  ],
  "languages": [
    "en"
  ],
  "lastEpisodeDateSince": "2026-08-25",
  "sortOrder": [
    {
      "field": "recentActivity",
      "direction": "desc"
    }
  ]
}'

const options = {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  },
  body: JSON.stringify({
  "searchTerms": [
    {
      "searchTargets": [
        "podcast-title",
        "podcast-title"
      ],
      "searchTerm": "podcast creation",
      "searchType": "text",
      "searchTermOptions": {
        "matchMode": "must",
        "phraseMatch": true,
        "slop": 1
      }
    }
  ],
  "languages": [
    "en"
  ],
  "lastEpisodeDateSince": "2026-08-25",
  "sortOrder": [
    {
      "field": "recentActivity",
      "direction": "desc"
    }
  ]
})
};

fetch("https://api.podengine.ai/api/v1/search/podcasts", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.post("https://api.podengine.ai/api/v1/search/podcasts", headers=headers, json={
  "searchTerms": [
    {
      "searchTargets": [
        "podcast-title",
        "podcast-title"
      ],
      "searchTerm": "podcast creation",
      "searchType": "text",
      "searchTermOptions": {
        "matchMode": "must",
        "phraseMatch": true,
        "slop": 1
      }
    }
  ],
  "languages": [
    "en"
  ],
  "lastEpisodeDateSince": "2026-08-25",
  "sortOrder": [
    {
      "field": "recentActivity",
      "direction": "desc"
    }
  ]
})
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var json = @"{
  ""searchTerms"": [
    {
      ""searchTargets"": [
        ""podcast-title"",
        ""podcast-title""
      ],
      ""searchTerm"": ""podcast creation"",
      ""searchType"": ""text"",
      ""searchTermOptions"": {
        ""matchMode"": ""must"",
        ""phraseMatch"": true,
        ""slop"": 1
      }
    }
  ],
  ""languages"": [
    ""en""
  ],
  ""lastEpisodeDateSince"": ""2026-08-25"",
  ""sortOrder"": [
    {
      ""field"": ""recentActivity"",
      ""direction"": ""desc""
    }
  ]
}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.podengine.ai/api/v1/search/podcasts", content);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	jsonData := []byte(`{
  "searchTerms": [
    {
      "searchTargets": [
        "podcast-title",
        "podcast-title"
      ],
      "searchTerm": "podcast creation",
      "searchType": "text",
      "searchTermOptions": {
        "matchMode": "must",
        "phraseMatch": true,
        "slop": 1
      }
    }
  ],
  "languages": [
    "en"
  ],
  "lastEpisodeDateSince": "2026-08-25",
  "sortOrder": [
    {
      "field": "recentActivity",
      "direction": "desc"
    }
  ]
}`)
	body := bytes.NewBuffer(jsonData)
	req, _ := http.NewRequest("POST", "https://api.podengine.ai/api/v1/search/podcasts", body)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.search.searchPodcasts({
  searchTerms: [
    {
      searchTargets: ['podcast-title', 'podcast-title'],
      searchTerm: 'podcast creation',
      searchType: 'text',
      searchTermOptions: {
        matchMode: 'must',
        phraseMatch: true,
        slop: 1,
      },
    },
  ],
  languages: ['en'],
  lastEpisodeDateSince: '2026-08-25',
  sortOrder: [
    {
      field: 'recentActivity',
      direction: 'desc',
    },
  ],
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.search.search_podcasts(
    search_terms=[
        {
            "searchTargets": ["podcast-title", "podcast-title"],
            "searchTerm": "podcast creation",
            "searchType": "text",
            "searchTermOptions": {
                "matchMode": "must",
                "phraseMatch": True,
                "slop": 1,
            },
        },
    ],
    languages=["en"],
    last_episode_date_since="2026-08-25",
    sort_order=[
        {
            "field": "recentActivity",
            "direction": "desc",
        },
    ],
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "searchMode": "podcasts",
    "searchId": "string",
    "searchOptions": {
      "cursor": "string",
      "pageSize": 1,
      "project": {
        "projectId": "string",
        "excludeIgnoredPodcasts": true,
        "excludePodcastsOnList": true,
        "includePodcastRelevancy": true,
        "excludeRelvancyValues": [
          1
        ],
        "forceRecalculateRelevancy": true
      },
      "projectId": "string",
      "searchTerms": [
        {
          "searchTerm": "string",
          "searchType": "text",
          "searchTargets": [
            "podcast-title"
          ],
          "searchTermOptions": {
            "matchMode": "optional",
            "phraseMatch": false,
            "fuzzy": false
          }
        }
      ],
      "excludeItunesGenres": [
        "string"
      ],
      "excludePodcastIds": [
        "string"
      ],
      "excludeEpisodeIds": [
        "string"
      ],
      "explicit": "clean",
      "foundedSince": null,
      "hasPrimaryContact": true,
      "hasSocials": [
        "beehiiv"
      ],
      "includeItunesGenres": [
        "string"
      ],
      "includePodcastIds": [
        "string"
      ],
      "languages": [
        "string"
      ],
      "lastEpisodeDateSince": "2026-01-15T09:30:00.000Z",
      "maxTotalEpisodes": 1,
      "minCastboxPlays": 1,
      "minCastboxSubscribers": 1,
      "minItunesRating": 0,
      "minItunesRatingCount": 1,
      "minSpotifyRating": 0,
      "minSpotifyRatingCount": 1,
      "minTotalEpisodes": 1,
      "podcastCountries": [
        "string"
      ],
      "podcastHasGuests": true,
      "podcastAuthorityScore": {
        "authorityScore": {
          "min": 0,
          "max": 0
        },
        "qualityScore": {
          "min": 0,
          "max": 0
        },
        "engagementScore": {
          "min": 0,
          "max": 0
        },
        "socialScore": {
          "min": 0,
          "max": 0
        },
        "youtubeScore": {
          "min": 0,
          "max": 0
        }
      },
      "podcastAudienceEstimatedMonthlyListeners": {
        "min": 0,
        "max": 0
      },
      "sortOrder": [
        {
          "field": "relevance",
          "direction": "asc",
          "nullOrder": "first"
        }
      ]
    },
    "searchResultsStats": {
      "time": {
        "totalTimeTakenMs": 0,
        "totalSearchTimeMs": 0,
        "totalPostProcessingTimeMs": 0
      },
      "totals": {
        "blacklistedPodcasts": 0,
        "projectExcludedPodcasts": 0,
        "totalResultsAvailable": 0,
        "resultsProcessed": 0,
        "resultsFiltered": 0,
        "resultsReturned": 0
      },
      "filters": {
        "relevancyScoresTotals": {
          "key": 0
        },
        "projectPodcastRelevancyScores": {
          "key": {
            "answer": {
              "rating": 1,
              "justification": "string",
              "strengths": "string",
              "concerns": "string"
            }
          }
        }
      }
    },
    "result": null,
    "cursor": "string"
  }
}

Request

Request body

Search terms1What to match on, and how

searchTermsarray of object4 fields

Terms to search for in podcast title and description

searchTermstringrequiredmin 2 characters

The text to look for. Wrapping it in single or double quotes forces a phrase match, the same as setting searchTermOptions.phraseMatch.

searchTypeenumrequired

How to match the term. 'text' runs keyword matching against each of the searchTargets. 'embeddings' is reserved for semantic search and is not accepted yet — a request using it is rejected.

textembeddings

searchTargetsarray of enumrequired

Which fields to match this term against. A result matches if the term hits any one of its targets, so listing several widens the search rather than narrowing it.

podcast-titlepodcast-description

searchTermOptionsobject4 fields

How this term is matched: whether it is required, treated as a phrase, or matched loosely.

matchModeenumdefault "optional"

How this term combines with the others. 'optional' (the default) lets the term raise a result's relevance without being required, though a result still has to match at least one term. 'must' requires it. 'not' excludes anything it matches.

mustnotoptional

phraseMatchboolean

Whether to match the search term as a phrase

slopnumber

How many words apart tokens can appear in a document to be considered a match

fuzzyboolean

Whether to use fuzzy matching

Filters21genres · ids · countries · languages · ratings · dates

includeItunesGenresarray of string

iTunes genres to include in results

excludeItunesGenresarray of string

iTunes genres to exclude from results

includePodcastIdsarray of string

Specific podcast IDs to include in results

excludePodcastIdsarray of string

Specific podcast IDs to exclude from results

excludeEpisodeIdsarray of string

Specific episode IDs to exclude from results

languagesarray of string

Filter podcasts by language

podcastCountriesarray of string

Filter podcasts by country of origin using ISO 3166-1 alpha-2 codes, for example us

explicitenum

Filter by explicit content rating

cleanexplicit

foundedSinceany

Filter podcasts founded after this date

lastEpisodeDateSincedate

Filter podcasts with episodes published after this date

minTotalEpisodesintegermin 1

Minimum number of total episodes

maxTotalEpisodesintegermin 1

Maximum number of total episodes

minItunesRatingnumber0 – 5

Minimum iTunes rating score

minItunesRatingCountintegermin 1

Minimum number of iTunes ratings

minSpotifyRatingnumber0 – 5

Minimum Spotify rating score

minSpotifyRatingCountintegermin 1

Minimum number of Spotify ratings

minCastboxPlaysintegermin 1

Minimum number of Castbox plays

minCastboxSubscribersintegermin 1

Minimum number of Castbox subscribers

hasPrimaryContactboolean

Filter podcasts that have primary contact information

hasSocialsarray of enum

Filter podcasts with specific social media presence from beehiiv, behance, bluesky, discord, facebook, github, instagram, linkedin, linktree, mastodon, medium, patreon, pinterest, reddit, snapchat, soundcloud, substack, threads, tiktok, tumblr, twitch, twitter, vimeo, whatsapp, youtube

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

podcastHasGuestsboolean

Filter podcasts that feature guests

Audience & scores2Authority score and estimated monthly listeners

podcastAuthorityScoreobject5 fields

Filter podcasts by their Authority Score

authorityScoreobject2 fields

Restrict results to podcasts whose overall Authority Score falls in this range. The overall score combines the quality, engagement, social and YouTube components; podcasts we have not scored are excluded. See https://www.podengine.ai/podcast-authority-score.

minnumberrequirednullable0 – 100

Inclusive lower bound for the overall Authority Score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the overall Authority Score. Null or omitted leaves the range open at the top.

qualityScoreobject2 fields

Restrict results by the quality component of the Authority Score, which rates how well the show is produced and maintained: release consistency, episode length, artwork, show notes, transcript coverage, contact details and RSS completeness. Podcasts we have not scored are excluded.

minnumberrequirednullable0 – 100

Inclusive lower bound for the quality score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the quality score. Null or omitted leaves the range open at the top.

engagementScoreobject2 fields

Restrict results by the engagement component of the Authority Score, which rates how strongly listeners respond to the show: review counts and ratings, recent Apple US chart position, and Castbox plays and subscribers. Podcasts we have not scored are excluded.

minnumberrequirednullable0 – 100

Inclusive lower bound for the engagement score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the engagement score. Null or omitted leaves the range open at the top.

socialScoreobject2 fields

Restrict results by the social component of the Authority Score, which rates follower counts across the show's linked Facebook, Instagram, LinkedIn, TikTok and Twitter accounts. Podcasts we have not scored are excluded.

minnumberrequirednullable0 – 100

Inclusive lower bound for the social score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the social score. Null or omitted leaves the range open at the top.

youtubeScoreobject2 fields

Restrict results by the YouTube component of the Authority Score, which rates the channel's subscribers, total views and most-viewed video. Podcasts we have not scored are excluded.

minnumberrequirednullable0 – 100

Inclusive lower bound for the YouTube score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the YouTube score. Null or omitted leaves the range open at the top.

podcastAudienceEstimatedMonthlyListenersobject2 fields

Filter by the published podcast monthly audience estimate (audio downloads plus YouTube views over 30 days). Bounds are inclusive; omit min or max for an open-ended range. Podcasts without an estimate are excluded. Example: { "min": 10000, "max": 100000 }.

minintegermin 0

Inclusive minimum monthly audience estimate

maxintegermin 0

Inclusive maximum monthly audience estimate

Project2Scope the search to a Pod Engine project

projectobject6 fields

Details about any Project this search is associated with. If included will filter out podcasts related to the project.

projectIdstringrequired

The Pod Engine Project ID

excludeIgnoredPodcastsboolean

If true, will not include any podcasts marked as ignored on this project in the results.

excludePodcastsOnListboolean

If true, will not include any podcasts on the project list in the results.

includePodcastRelevancyboolean

If the podcast relevancy should be included with the search results. Note that including this will limit your search results to 20 total and also slow down the search results response

excludeRelvancyValuesarray of number

If provided, will exclude podcasts with these relevancy values. Valid values are 1-5. Note this is a server side filter and will only work if includePodcastRelevancy is set.

forceRecalculateRelevancyboolean

If true, will force a recalculation of the podcast relevancy values for this search. Note this will slow down the search results response and should only be used if you believe the relevancy values are out of date.

projectIdstring

[DEPRECATED] Project ID to associate the search with

Sorting1field · direction · nullOrder

sortOrderarray of object3 fields

Specify how results should be sorted

fieldenumrequired

What to order by. 'relevance' is the search score. 'recentActivity' is the episode's publication date when searching episodes, and the podcast's most recent episode date when searching podcasts. 'title' orders alphabetically. 'appleReviews' and 'spotifyReviews' order by a rating that weighs the number of reviews as well as the average, so a 5.0 from three listeners does not outrank a 4.7 from thousands.

relevancerecentActivitytitleappleReviewsspotifyReviews

directionenum

Sort direction. Defaults to 'asc' for 'title' and 'desc' for every other field.

ascdesc

nullOrderenum

Where results that have no value for this field go. Defaults to 'last'. Ignored for 'relevance', which every result has.

firstlast

Pagination2Cursor-based paging

cursorstringnullable

Pagination cursor for fetching the next page of results. This cursor is stateless and does not expire. However, because it uses search_after pagination, results may be inconsistent if the underlying data changes between requests (e.g., you may see duplicate or missing results if documents are added/removed).

pageSizeinteger1 – 1000

Number of results to return per page

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired6 fields

searchModeliteral: podcastsrequired

searchIdstringrequired

searchOptionsobjectrequired29 fields

cursorstringnullable

pageSizeinteger1 – 1000

Number of results to return per page

projectobject6 fields

Details about any Project this search is associated with. If included will filter out podcasts related to the project.

projectIdstringrequired

The Pod Engine Project ID

excludeIgnoredPodcastsboolean

If true, will not include any podcasts marked as ignored on this project in the results.

excludePodcastsOnListboolean

If true, will not include any podcasts on the project list in the results.

includePodcastRelevancyboolean

If the podcast relevancy should be included with the search results. Note that including this will limit your search results to 20 total and also slow down the search results response

excludeRelvancyValuesarray of number

If provided, will exclude podcasts with these relevancy values. Valid values are 1-5. Note this is a server side filter and will only work if includePodcastRelevancy is set.

forceRecalculateRelevancyboolean

projectIdstring

[DEPRECATED] Project ID to associate the search with

searchTermsarray of object4 fields

Terms to search for in podcast title and description

searchTermstringrequiredmin 2 characters

The text to look for. Wrapping it in single or double quotes forces a phrase match, the same as setting searchTermOptions.phraseMatch.

searchTypeenumrequired

How to match the term. 'text' runs keyword matching against each of the searchTargets. 'embeddings' is reserved for semantic search and is not accepted yet — a request using it is rejected.

textembeddings

searchTargetsarray of enumrequired

Which fields to match this term against. A result matches if the term hits any one of its targets, so listing several widens the search rather than narrowing it.

podcast-titlepodcast-description

searchTermOptionsobject4 fields

How this term is matched: whether it is required, treated as a phrase, or matched loosely.

matchModeenumdefault "optional"

mustnotoptional

phraseMatchboolean

Whether to match the search term as a phrase

slopnumber

How many words apart tokens can appear in a document to be considered a match

fuzzyboolean

Whether to use fuzzy matching

excludeItunesGenresarray of string

iTunes genres to exclude from results

excludePodcastIdsarray of string

Specific podcast IDs to exclude from results

excludeEpisodeIdsarray of string

Specific episode IDs to exclude from results

explicitenum

Filter by explicit content rating

cleanexplicit

foundedSinceany

Filter podcasts founded after this date

hasPrimaryContactboolean

Filter podcasts that have primary contact information

hasSocialsarray of enum

beehiivbehanceblueskydiscordfacebookgithubinstagramlinkedinlinktreemastodonmediumpatreonpinterestredditsnapchatsoundcloudsubstackthreadstiktoktumblrtwitchtwittervimeowhatsappyoutube

includeItunesGenresarray of string

iTunes genres to include in results

includePodcastIdsarray of string

Specific podcast IDs to include in results

languagesarray of string

Filter podcasts by language

lastEpisodeDateSincedate

Filter podcasts with episodes published after this date

maxTotalEpisodesintegermin 1

Maximum number of total episodes

minCastboxPlaysintegermin 1

Minimum number of Castbox plays

minCastboxSubscribersintegermin 1

Minimum number of Castbox subscribers

minItunesRatingnumber0 – 5

Minimum iTunes rating score

minItunesRatingCountintegermin 1

Minimum number of iTunes ratings

minSpotifyRatingnumber0 – 5

Minimum Spotify rating score

minSpotifyRatingCountintegermin 1

Minimum number of Spotify ratings

minTotalEpisodesintegermin 1

Minimum number of total episodes

podcastCountriesarray of string

Filter podcasts by country of origin using ISO 3166-1 alpha-2 codes, for example us

podcastHasGuestsboolean

Filter podcasts that feature guests

podcastAuthorityScoreobject5 fields

Filter podcasts by their Authority Score

authorityScoreobject2 fields

minnumberrequirednullable0 – 100

Inclusive lower bound for the overall Authority Score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the overall Authority Score. Null or omitted leaves the range open at the top.

qualityScoreobject2 fields

minnumberrequirednullable0 – 100

Inclusive lower bound for the quality score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the quality score. Null or omitted leaves the range open at the top.

engagementScoreobject2 fields

minnumberrequirednullable0 – 100

Inclusive lower bound for the engagement score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the engagement score. Null or omitted leaves the range open at the top.

socialScoreobject2 fields

minnumberrequirednullable0 – 100

Inclusive lower bound for the social score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the social score. Null or omitted leaves the range open at the top.

youtubeScoreobject2 fields

Restrict results by the YouTube component of the Authority Score, which rates the channel's subscribers, total views and most-viewed video. Podcasts we have not scored are excluded.

minnumberrequirednullable0 – 100

Inclusive lower bound for the YouTube score. Null or omitted leaves the range open at the bottom.

maxnumberrequirednullable0 – 100

Inclusive upper bound for the YouTube score. Null or omitted leaves the range open at the top.

podcastAudienceEstimatedMonthlyListenersobject2 fields

minintegermin 0

Inclusive minimum monthly audience estimate

maxintegermin 0

Inclusive maximum monthly audience estimate

sortOrderarray of object3 fields

Specify how results should be sorted

fieldenumrequired