curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/guests/expertise?limit=10"{
"fields": [
{
"appearances": 123,
"code": "<string>",
"guests": 123,
"level": 123,
"share": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"guest_appearances": 123,
"guests": 123,
"in_field": {
"appearances": 123,
"share": 123
},
"occupations": [
{
"appearances": 123,
"code": "<string>",
"guests": 123,
"level": 123,
"share": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"promotional": {
"appearances": 123,
"share": 123
},
"seniority": {
"distinguished": {
"appearances": 123,
"share": 123
},
"professional": {
"appearances": 123,
"share": 123
},
"senior": {
"appearances": 123,
"share": 123
}
},
"standing": {
"established": {
"appearances": 123,
"share": 123
},
"self_described": {
"appearances": 123,
"share": 123
},
"unverified": {
"appearances": 123,
"share": 123
}
},
"updated_at": "2023-11-07T05:31:56Z"
}{
"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"
}Get the expertise of a podcast's guests
Returns the show’s guest-expertise profile over every guest and panelist appearance analyzed for expertise, all time: how many there were, the share whose standing others conferred, who spoke within their field, and who came mainly to promote something, the guests’ seniority, and their most common occupations and fields of research. Appearances whose analysis doubts the guest is the person linked are left out. The profile is rebuilt at most once a day. For each guest’s own expertise, use GET /v1/people//expertise; for one episode’s guests, GET /v1/podcasts/episodes//expertise.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/guests/expertise?limit=10"{
"fields": [
{
"appearances": 123,
"code": "<string>",
"guests": 123,
"level": 123,
"share": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"guest_appearances": 123,
"guests": 123,
"in_field": {
"appearances": 123,
"share": 123
},
"occupations": [
{
"appearances": 123,
"code": "<string>",
"guests": 123,
"level": 123,
"share": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"promotional": {
"appearances": 123,
"share": 123
},
"seniority": {
"distinguished": {
"appearances": 123,
"share": 123
},
"professional": {
"appearances": 123,
"share": 123
},
"senior": {
"appearances": 123,
"share": 123
}
},
"standing": {
"established": {
"appearances": 123,
"share": 123
},
"self_described": {
"appearances": 123,
"share": 123
},
"unverified": {
"appearances": 123,
"share": 123
}
},
"updated_at": "2023-11-07T05:31:56Z"
}{
"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).
Path Parameters
Podcast slug, internal ID, or numeric iTunes ID.
Query Parameters
How many occupations and how many fields to list (1-50, default 10).
1 <= x <= 50Response
OK
The guests' most common ANZSRC 2020 field-of-research groups, most appearances first.
Show child attributes
Show child attributes
Guest and panelist appearances on the show analyzed for expertise, one per guest per episode, all time. Appearances whose analysis doubts the guest is the person linked are left out. The shares below are of this count.
The distinct people behind those appearances.
Appearances where the guest spoke within their field.
Show child attributes
Show child attributes
The guests' most common SOC 2018 detailed occupations, most appearances first.
Show child attributes
Show child attributes
Appearances where the guest was there mainly to promote something.
Show child attributes
Show child attributes
The guests' seniority, each level counting the guests at it or above.
Show child attributes
Show child attributes
How the guests' standing is recognized, as GET /v1/people/{id}/expertise describes it.
Show child attributes
Show child attributes
When the profile was last rebuilt. It is rebuilt at most once a day, so the latest episodes may not count yet. Omitted when the show has no analyzed guest appearance.
Was this page helpful?