Podcast Guests
tier:standard

List podcast guests

Returns a paginated directory of Persons who have appeared on at least one podcast episode in a non-host listing role. Filter by name, topic, podcast, date, and brand-safety tier.

get/v1/podcasts/guests

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/guests
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

qstring

Case-insensitive substring match against the guest's display name

min_appearancesinteger

Minimum lifetime appearance count to include (default 1)

podcast_idstring

Restrict to guests who have appeared on this podcast (slug or ID)

topic_idstring

Restrict to guests with at least one appearance on an episode classified under this topic

appeared_sincestring

Only include guests with at least one appearance published on or after this ISO 8601 date

suitability_tier_max'SAFE' | 'LIMITED' | 'SENSITIVE' | 'UNSAFE'

Restrict to guests whose appearances are on podcasts at or below this IAB Tech Lab brand-safety tier

sort'appearances' | 'recency'

Sort order (default: appearances)

occupationstring

Only guests listed under this SOC 2018 or ISCO-08 occupation (code, slug, or title), including a SOC group or everyday name such as physicians or doctors. A word with no occupation filters by the field of research or capacity it names: oncologists is field 3211, founders is capacity=executive_founder.

fieldstring

Only guests listed under this ANZSRC 2020 field of research (code, slug, or title).

standing'established' | 'self_described' | 'unverified'

Only guests whose standing is recognized this way.

seniority'professional' | 'senior' | 'distinguished'

Only guests at this seniority or above.

practicingboolean

Only guests who still work in the occupation; needs a SOC 2018 occupation or group.

capacity'researcher' | 'licensed_professional' | 'practitioner' | 'executive_founder' | 'public_official' | 'journalist_analyst' | 'creator_entertainer' | 'athlete_coach' | 'clergy' | 'firsthand' | 'layperson'

Only guests who know their field in this capacity.

employerstring

Only guests whose organization is this company (slug, domain, or ID).

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.