---
title: "List entities"
method: GET
path: "/v1/entities"
tags: ["Entities", "tier:standard"]
---

# List entities

`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

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.

## Query parameters

- `limit` integer: Results per page
- `cursor` string: Opaque pagination cursor from previous response
- `ids` string[], 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.
- `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`

OK

- PageEntity
  - `cursor` string: Pass to next request for more results
  - `data` Entity[], nullable, required: List of results
    - `company` EntityCompany
      - `domain` string: Company website domain
      - `id` string, required: Company identifier
      - `ticker` string: Primary stock ticker symbol
    - `description` string: Short description
    - `id` string, required: Unique identifier
    - `image_url` string: Entity image URL
    - `name` string, required: Entity name
    - `person` EntityPerson
      - `company` string: Current company name
      - `id` string, required: Person identifier
      - `image_url` string: Person headshot URL
      - `title` string: Current role title
    - `slug` string, required: Human-readable slug identifier
    - `type` EntityType
      - `name` string, required: Human-friendly display label (e.g. 'Company').
      - `slug` string, required: Stable identifier, safe to pass to the type query parameter (e.g. 'company').
    - `wikipedia_url` string: Wikipedia URL
  - `has_more` boolean, required: Whether more results exist

## Other responses

- `402`: Payment Required. Read error_code. payment_required is the x402 path: either a keyless request being challenged — pay $0.01 in USDC per request (requirements in the PAYMENT-REQUIRED header) or send a pp_ API key — or a supplied payment that failed settlement (details in the PAYMENT-RESPONSE header; retry the same signature before signing a new one). See https://docs.particle.pro/x402. Any other code means the credential was accepted but does not cover this request (a plan or session gate such as premium_required or paid_plan_confirmation_required); its resolve says how to obtain access, and no payment header is sent.
- `default`: Error

---

[API](https://skmtc.dev/particle/apis/particle-api.md) · [All operations](https://skmtc.dev/particle/apis/particle-api/llms.txt) · [OpenAPI document](https://skmtc.dev/particle/apis/particle-api/revisions/416ba82ab9d7?raw)