curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/fields/{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 a field of research's guests
Ranks the people listed under an ANZSRC 2020 field of research 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. The parameter accepts the code, slug, or title. For the shows that book them, use GET /v1/people/fields//podcasts.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/fields/{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?