Entities
tier:standard

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

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/entities
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

idsstring[] nullable

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.

[
  "sam-altman",
  "openai"
]
podcast_idstring

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).

typestring

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

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.