List entities

List knowledge graph entities (people, organizations, places) across all podcast content. Defaults to the most frequently appearing entities, ranked by the number of distinct podcast episodes featuring them. Filter by podcast slug or ID, or fetch specific entities with ids. To search by name, use GET /v1/entities/search.

GET /v1/entities

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/entities?limit=25"

200

{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>",
      "company": {
        "id": "<string>",
        "domain": "<string>",
        "ticker": "<string>"
      },
      "description": "<string>",
      "image_url": "<string>",
      "person": {
        "id": "<string>",
        "company": "<string>",
        "image_url": "<string>",
        "title": "<string>"
      },
      "type": {
        "name": "<string>",
        "slug": "<string>"
      },
      "wikipedia_url": "<string>"
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

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

Query Parameters

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

ids · string[] | null

Bulk multi-get: one or more entity slugs (e.g. 'sam-altman', 'apple') or IDs, comma-separated (max 100). When set, returns exactly those entities and the other filters (type, podcast_id) and pagination are ignored. Refs that don't resolve are omitted from the response.

Maximum array length: 100

Example:

["sam-altman", "openai"]

podcast_id · string

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID. Filter to entities a specific podcast covers, ranked by how many of its latest 500 episodes mention them (ad reads and the show's own hosts excluded).

type · string

Filter to an entity category. See GET /v1/entities/types for the available slugs (e.g. 'person', 'company', 'movie', 'sports-team').

Response

200

application/json

OK

data · object[] · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results