Skip to main content
Entities are people, organizations, and places extracted from content and linked to a knowledge graph. They are the connective tissue of the Particle API platform — the same entity appears across podcast episodes, articles, and company profiles, making cross-referencing possible.

​
Search entities

Find entities by name: 
curl "https://api.particle.pro/v1/entities?q=Sam+Altman" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response schema

​
data
Entity[]
required
​
has_more
boolean
required
Whether more results exist beyond this page.
​
cursor
string
Pass to the next request for the next page.
Example response
{
  "data": [
    {
      "id": "Lm0wOWM3dzA",
      "name": "Sam Altman",
      "description": "American entrepreneur and CEO of OpenAI",
      "wikipedia_url": "https://en.wikipedia.org/wiki/Sam_Altman",
      "image_url": "https://..."
    }
  ],
  "has_more": false
}

​
Filtering

ParameterDescriptionExample
qSearch entity names?q=Sam+Altman
podcast_idFilter to entities appearing in a specific podcast?podcast_id=2dMXSZK8Xx...

​
Get a single entity

curl "https://api.particle.pro/v1/entities/Lm0wOWM3dzA" \
  -H "X-API-Key: YOUR_API_KEY"
Returns the same entity schema without the pagination wrapper.

​
Entity appearances

The key cross-referencing endpoint. Given an entity, find every podcast episode where they appear: 
curl "https://api.particle.pro/v1/entities/Lm0wOWM3dzA/appearances" \
  -H "X-API-Key: YOUR_API_KEY"
This returns episodes where the entity was identified as a speaker — complete with the speaker’s role, speaking duration, and the full episode context.

​
Tracking a person across podcasts

A common pattern: find the entity ID from a speakers list, then query their appearances.
1

Get speakers from an episode

curl ".../v1/podcasts/episodes/6OdMXSZK8XxM89hbS3eanr/speakers"
Note the entity_id for the speaker you want to track.
2

Find all their appearances

curl "https://api.particle.pro/v1/entities/Lm0wOWM3dzA/appearances"
Returns every episode where this person appeared as a speaker across all podcasts.

​
Cross-referencing with companies

Entities link to companies through the entity_id field in company identifiers. You can look up a company by its linked entity: 
curl "https://api.particle.pro/v1/companies?entity_id=Lm0wOWM3dzA" \
  -H "X-API-Key: YOUR_API_KEY"
This bridges the knowledge graph with structured company data — find an entity in a podcast, then pull their full company profile.