curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations/{code}/guests?limit=25&min_podcasts=1"{
"data": [
{
"appearances": 123,
"last_appeared_at": "2023-11-07T05:31:56Z",
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"podcasts": 123,
"rank": 123
}
],
"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"
}Rank an occupation's guests
Ranks the people listed under an occupation by their podcast guest and panelist appearances in a window of publication dates (the last 30 days by default), then by the distinct shows they appeared on. Raise min_podcasts to favor guests booked across the medium over one show’s regulars. Appearances follow the rules of GET /v1/podcasts/episodes?guest_occupation=: settled links only, and none whose analysis doubts the guest is the person linked. The parameter accepts the code, slug, or title. For the shows that book them, use GET /v1/people/occupations//podcasts.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations/{code}/guests?limit=25&min_podcasts=1"{
"data": [
{
"appearances": 123,
"last_appeared_at": "2023-11-07T05:31:56Z",
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"podcasts": 123,
"rank": 123
}
],
"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).
Path Parameters
The occupation's or field's code, slug, or title, as GET /v1/people/occupations and GET /v1/people/fields list them.
200Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Only appearances on episodes published on or after this date. Defaults to 30 days ago; the window may span at most 90 days.
"2026-09-01"
Only appearances on episodes published on or before this date; a bare date includes that whole day. Defaults to now.
"2026-09-30"
Only count guests whose standing in their expertise is recognized this way: established (credentialed or widely recognized), self_described, or unverified.
established, self_described, unverified Only guests who appeared on at least this many distinct shows in the window. Raise it to favor guests booked across the medium over a show's regulars.
x >= 1Was this page helpful?