Skip to main content
GET
/
v1
/
podcasts
/
guests
/
{id}
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/guests/{id}"
{
  "id": "<string>",
  "name": "<string>",
  "stats": {
    "appearance_count": 123,
    "distinct_podcasts": 123,
    "appearances_by_bias": {},
    "appearances_by_suitability_tier": {},
    "first_appearance_at": "2023-11-07T05:31:56Z",
    "last_appearance_at": "2023-11-07T05:31:56Z",
    "total_speaking_seconds": 123
  },
  "current_role": {
    "company": {
      "id": "<string>",
      "name": "<string>",
      "image_url": "<string>"
    },
    "is_current": true,
    "ended_at": "2023-11-07T05:31:56Z",
    "started_at": "2023-11-07T05:31:56Z",
    "title": "<string>"
  },
  "description": "<string>",
  "detailed_description": "<string>",
  "external_links": [
    {
      "platform": {
        "display_name": "<string>",
        "name": "<string>"
      },
      "attributes": [
        {
          "name": "<string>",
          "value": "<unknown>",
          "category": "<string>",
          "observed_at": "2023-11-07T05:31:56Z"
        }
      ],
      "identifier": "<string>",
      "url": "<string>"
    }
  ],
  "image_url": "<string>",
  "knowledge_graph_entity": {
    "id": "<string>",
    "slug": "<string>",
    "wikipedia_url": "<string>"
  },
  "roles": [
    {
      "company": {
        "id": "<string>",
        "name": "<string>",
        "image_url": "<string>"
      },
      "is_current": true,
      "ended_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "title": "<string>"
    }
  ],
  "slug": "<string>",
  "top_podcasts": [
    {
      "appearance_count": 123,
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "image_url": "<string>",
        "slug": "<string>"
      },
      "bias": "<string>",
      "first_appearance_at": "2023-11-07T05:31:56Z",
      "last_appearance_at": "2023-11-07T05:31:56Z",
      "suitability_tier": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

​
id
string
required

Person identifier. Accepts the Person slug (recommended; returned as 'slug' on every guest payload) or the encoded Person UUID returned as 'id'.

Response

OK

​
id
string
required

Encoded Person identifier

​
name
string
required

Display name

​
stats
object
required

Lifetime appearance statistics across the corpus

​
current_role
object

The Person's most recent company role, when known.

​
description
string

Short bio (one-liner) curated for the Person.

​
detailed_description
string

Longer Wikipedia-grounded bio when available.

​
external_links
object[] | null

Known third-party profiles (LinkedIn, Wikipedia, social). Discovered asynchronously; a freshly-resolved Person may not yet have all platforms populated.

​
image_url
string

Canonical headshot URL when one is known for the Person

​
knowledge_graph_entity
object

Linked knowledge graph entity, when one exists. Secondary identifier — most callers should rely on id/slug.

​
roles
object[] | null

All known company roles, ordered most-recent first. Includes the current role at index 0.

​
slug
string

Stable human-readable handle (e.g. 'satya-nadella'). Recommended canonical identifier on every Particle Pro person surface.

​
top_podcasts
object[] | null

Up to five most-frequent podcasts the guest has appeared on