{
"data": [
{
"appearance_count": 123,
"id": "<string>",
"name": "<string>",
"description": "<string>",
"distinct_podcasts": 123,
"expertise": {
"standing": "established",
"fields": [
{
"code": "<string>",
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"group": "minor",
"level": 123,
"parent_code": "<string>"
}
],
"occupations": [
{
"code": "<string>",
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"established": true,
"group": "minor",
"level": 123,
"parent_code": "<string>",
"practicing": true
}
],
"seniority": "professional"
},
"first_appearance_at": "2023-11-07T05:31:56Z",
"image_url": "<string>",
"last_appearance_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}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.
{
"data": [
{
"appearance_count": 123,
"id": "<string>",
"name": "<string>",
"description": "<string>",
"distinct_podcasts": 123,
"expertise": {
"standing": "established",
"fields": [
{
"code": "<string>",
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"group": "minor",
"level": 123,
"parent_code": "<string>"
}
],
"occupations": [
{
"code": "<string>",
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"established": true,
"group": "minor",
"level": 123,
"parent_code": "<string>",
"practicing": true
}
],
"seniority": "professional"
},
"first_appearance_at": "2023-11-07T05:31:56Z",
"image_url": "<string>",
"last_appearance_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Case-insensitive substring match against the guest's display name
Minimum lifetime appearance count to include (default 1)
x >= 1Restrict to guests who have appeared on this podcast (slug or ID)
Restrict to guests with at least one appearance on an episode classified under this topic
Only include guests with at least one appearance published on or after this ISO 8601 date
Restrict to guests whose appearances are on podcasts at or below this IAB Tech Lab brand-safety tier
SAFE, LIMITED, SENSITIVE, UNSAFE Sort order (default: appearances)
appearances, recency 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.
200Only guests listed under this ANZSRC 2020 field of research (code, slug, or title).
200Only guests whose standing is recognized this way.
established, self_described, unverified Only guests at this seniority or above.
professional, senior, distinguished Only guests who still work in the occupation; needs a SOC 2018 occupation or group.
Only guests who know their field in this capacity.
researcher, licensed_professional, practitioner, executive_founder, public_official, journalist_analyst, creator_entertainer, athlete_coach, clergy, firsthand, layperson Only guests whose organization is this company (slug, domain, or ID).
Was this page helpful?