Search podcasts

Searches the podcast catalog by show name — the canonical podcast search. Functionally equivalent to GET /v1/podcasts?q=…: the same forgiving, typo-tolerant ranked search, the same filters (topic, language, suitability tier, popularity, format), and the same match_quality signal on each result. To search inside episode dialogue, use /v1/podcasts/episodes/search instead.

GET /v1/podcasts/search

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/search?limit=25"

200

{
  "data": [
    {
      "explicit": true,
      "id": "<string>",
      "title": "<string>",
      "bias": "<string>",
      "description": "<string>",
      "episode_count": 123,
      "format": {
        "has_video": true,
        "avg_episode_minutes": 123,
        "episodes_per_week": 123,
        "guest_frequency": "<string>",
        "has_ads": true,
        "publishing_status": "<string>",
        "signals": [
          "<string>"
        ]
      },
      "image_url": "<string>",
      "language": "<string>",
      "match_quality": "exact",
      "political_context": "<string>",
      "popularity": 123,
      "publisher": {
        "id": "<string>",
        "name": "<string>",
        "slug": "<string>"
      },
      "recommended_guests": [
        {
          "band": "strong",
          "person": {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "image_url": "<string>",
            "slug": "<string>"
          },
          "score": 123,
          "shared_show_count": 123,
          "via": [
            {
              "id": "<string>",
              "title": "<string>",
              "best_rank": {
                "captured_at": "2023-11-07T05:31:56Z",
                "chart_type": "top_podcasts",
                "rank": 123,
                "source": "apple",
                "category_slug": "<string>",
                "country": "<string>"
              },
              "image_url": "<string>",
              "popularity": 123,
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            }
          ]
        }
      ],
      "recommended_sponsors": [
        {
          "band": "strong",
          "score": 123,
          "shared_show_count": 123,
          "sponsor": {
            "id": "<string>",
            "name": "<string>",
            "company": {
              "id": "<string>",
              "name": "<string>",
              "description": "<string>",
              "domain": "<string>",
              "image_mode": "AUTOMATIC",
              "image_url": "<string>",
              "slug": "<string>",
              "ticker": "<string>"
            }
          },
          "total_ads": 123,
          "contacts": [
            {
              "person": {
                "id": "<string>",
                "name": "<string>",
                "description": "<string>",
                "image_url": "<string>",
                "slug": "<string>"
              },
              "role": "marketing",
              "linkedin_url": "<string>",
              "title": "<string>"
            }
          ],
          "last_ad_at": "2023-11-07T05:31:56Z",
          "via": [
            {
              "id": "<string>",
              "title": "<string>",
              "best_rank": {
                "captured_at": "2023-11-07T05:31:56Z",
                "chart_type": "top_podcasts",
                "rank": 123,
                "source": "apple",
                "category_slug": "<string>",
                "country": "<string>"
              },
              "image_url": "<string>",
              "popularity": 123,
              "publisher": {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>"
              },
              "slug": "<string>"
            }
          ]
        }
      ],
      "related": [
        {
          "band": "strong",
          "podcast": {
            "id": "<string>",
            "title": "<string>",
            "best_rank": {
              "captured_at": "2023-11-07T05:31:56Z",
              "chart_type": "top_podcasts",
              "rank": 123,
              "source": "apple",
              "category_slug": "<string>",
              "country": "<string>"
            },
            "image_url": "<string>",
            "popularity": 123,
            "publisher": {
              "id": "<string>",
              "name": "<string>",
              "slug": "<string>"
            },
            "slug": "<string>"
          },
          "score": 123,
          "basis": {
            "same_publisher": true,
            "shared_category_count": 123,
            "shared_guest_count": 123,
            "shared_sponsor_count": 123,
            "content_similarity": 123,
            "shared_guests": [
              {
                "id": "<string>",
                "name": "<string>",
                "description": "<string>",
                "image_url": "<string>",
                "slug": "<string>"
              }
            ],
            "shared_topics": [
              {
                "id": "<string>",
                "name": "<string>",
                "slug": "<string>",
                "ancestry": "<string>",
                "ancestry_path": "<string>",
                "episode_count": 123
              }
            ],
            "topic_overlap": 123
          }
        }
      ],
      "slug": "<string>",
      "speakers": [
        {
          "name": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>",
            "company": {
              "id": "<string>",
              "domain": "<string>",
              "ticker": "<string>"
            },
            "description": "<string>",
            "image_url": "<string>",
            "person": {
              "id": "<string>",
              "company": "<string>",
              "image_url": "<string>",
              "title": "<string>"
            },
            "type": {
              "name": "<string>",
              "slug": "<string>"
            },
            "wikipedia_url": "<string>"
          },
          "occurrences": 123,
          "role": "<string>"
        }
      ],
      "suitability_tier": "<string>",
      "topics": [
        {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "ancestry": "<string>",
          "ancestry_path": "<string>",
          "episode_count": 123
        }
      ],
      "url": "<string>"
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

q · string

Search the catalog by podcast name. GET /v1/podcasts/search is the canonical search endpoint and accepts the same parameters. The search is forgiving: it handles typos, missing or extra words ('offline jon favreau' finds Offline with Jon Favreau), a name plus qualifiers ('equity techcrunch'), and pasted episode titles ('Ferrari | Acquired' finds Acquired). The best matches come first, and each result's match_quality tells you how confident the match is — including when a show matched only through its description (match_quality=description) rather than its name.

Maximum string length: 200

sort · enum<string>

Result ordering. relevance — the default whenever q is present — ranks by how well each podcast matches the query, breaking ties by popularity. popularity orders purely by the global popularity percentile (most popular first; podcasts not currently charting sort last), and also overrides topic_id's concentration ordering. Without q or topic_id, results are popularity-ordered either way.

Available options: relevance, popularity

slug · string

Filter by exact podcast slug (e.g., 'all-in'). Slugs are stable, human-readable identifiers returned on every podcast object.

Maximum string length: 200

topic_id · string

Filter by topic ID, ancestry slug (e.g., technology/artificial-intelligence), or ancestry path hash. Matches podcasts where the topic accounts for at least 20% of the show's episodes, ranked by topic concentration — not merely podcasts that mention it once.

language · string

Filter by the podcast's language (ISO 639-1 code, e.g. 'en', 'fr'). Matches the primary language subtag, so 'fr' covers 'fr-FR'.

Example:

"fr"

suitability_tier · enum<string>

Filter by brand-suitability tier (IAB Tech Lab Brand Safety & Suitability Framework, formerly GARM). Only returns podcasts whose most recent suitability analysis assigned this tier. Podcasts without a suitability analysis are excluded when this filter is set.

Available options: SAFE, LIMITED, SENSITIVE, UNSAFE

popularity_threshold · number<double>

Restrict results to podcasts whose global popularity percentile is at least this value (accepted range [0,1]). Omitting the parameter or passing 0 disables the filter; only a value greater than 0 activates it. Popularity is always global — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts) — never scoped to topic_id or any other filter. When the filter is active (threshold > 0), podcasts not currently charting have no percentile and are excluded, so a high threshold combined with a narrow topic_id may return zero results; lower or remove the threshold to widen the set.

Required range: 0 <= x <= 1

guest_frequency · enum<string>[] | null

Filter by how often episodes feature a guest. Pass a comma-separated list to match any of several buckets — e.g. regular,always for interview-driven shows, or never for shows that don't host guests. Only matches podcasts with enough analyzed episodes to judge; values mirror the format.guest_frequency field on podcast responses.

Maximum array length: 5

Available options: never, rare, occasional, regular, always

Example:

["regular", "always"]

format_signal · enum<string>[] | null

Filter by detected production format. Pass a comma-separated list to match any of several formats — e.g. panel,call_in. Values mirror the format.signals field on podcast responses; a show can carry several signals.

Maximum array length: 4

Available options: interview, panel, call_in, solo_narrated

Example:

["interview"]

has_ads · enum<string>

Filter by advertiser presence. Pass false to find ad-free shows — an assertion that requires the show to have enough analyzed episodes, so sparsely-analyzed podcasts are excluded rather than presumed ad-free.

Available options: true, false

has_video · enum<string>

Filter by whether episodes have discovered video versions (e.g. YouTube releases).

Available options: true, false

min_avg_episode_minutes · integer<int64>

Only podcasts whose average episode runs at least this many minutes. Combine with max_avg_episode_minutes to target a length band (e.g. 20–40 minute commute shows).

Required range: 0 <= x <= 10080

max_avg_episode_minutes · integer<int64>

Only podcasts whose average episode runs at most this many minutes.

Required range: 0 <= x <= 10080

min_episodes_per_week · number<double>

Only podcasts publishing at least this many episodes per week on average (e.g. 5 for weekday dailies). Cadence is measured over the trailing 90 days; podcasts tracked too briefly to measure are excluded.

Required range: x >= 0

max_episodes_per_week · number<double>

Only podcasts publishing at most this many episodes per week on average (e.g. 0.5 for fortnightly-or-slower shows).

Required range: x >= 0

publishing_status · enum<string>

Filter by publishing activity: active shows have released an episode within the last 90 days; dormant shows have not.

Available options: active, dormant

Response

200

application/json

OK

data · object[] | null · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results