> ## 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. # 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. ## OpenAPI ````yaml /openapi.json get /v1/entities openapi: 3.1.0 info: description: Public API for Particle — news intelligence, financial data, and analysis. title: Particle API version: 0.1.0 servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] paths: /v1/entities: get: tags: - Entities - tier:standard summary: List entities description: >- 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. operationId: list-entities parameters: - description: Results per page explode: false in: query name: limit schema: default: 25 description: Results per page format: int64 maximum: 100 minimum: 1 type: integer - description: Opaque pagination cursor from previous response explode: false in: query name: cursor schema: description: Opaque pagination cursor from previous response type: string - description: >- 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. explode: false in: query name: ids schema: description: >- 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. examples: - - sam-altman - openai items: type: string maxItems: 100 type: - array - 'null' - description: >- Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID. Filter to entities appearing in a specific podcast. explode: false in: query name: podcast_id schema: description: >- Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID. Filter to entities appearing in a specific podcast. type: string - description: >- Filter to an entity category. See GET /v1/entities/types for the available slugs (e.g. 'person', 'company', 'movie', 'sports-team'). explode: false in: query name: type schema: description: >- Filter to an entity category. See GET /v1/entities/types for the available slugs (e.g. 'person', 'company', 'movie', 'sports-team'). type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/PageEntity' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/entities?limit=25" components: schemas: PageEntity: additionalProperties: false properties: cursor: description: Pass to next request for more results type: string data: description: List of results items: $ref: '#/components/schemas/Entity' type: - array - 'null' has_more: description: Whether more results exist type: boolean required: - data - has_more type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object Entity: additionalProperties: false properties: company: $ref: '#/components/schemas/EntityCompany' description: Linked company record, if this entity is a known company description: description: Short description type: string id: description: Unique identifier type: string image_url: description: Entity image URL type: string name: description: Entity name type: string person: $ref: '#/components/schemas/EntityPerson' description: Linked person record, if this entity is a known person slug: description: Human-readable slug identifier type: string type: $ref: '#/components/schemas/EntityType' description: Category. Omitted when the entity falls outside the supported set. wikipedia_url: description: Wikipedia URL type: string required: - id - slug - name type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object EntityCompany: additionalProperties: false properties: domain: description: Company website domain type: string id: description: Company identifier type: string ticker: description: Primary stock ticker symbol type: string required: - id type: object EntityPerson: additionalProperties: false properties: company: description: Current company name type: string id: description: Person identifier type: string image_url: description: Person headshot URL type: string title: description: Current role title type: string required: - id type: object EntityType: additionalProperties: false properties: name: description: Human-friendly display label (e.g. 'Company'). type: string slug: description: >- Stable identifier, safe to pass to the type query parameter (e.g. 'company'). type: string required: - slug - name type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ````