> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find by details

> Find people such as executives, politicians and public figures. Search by name or description and narrow the results by position, employer, nationality or gender.



## OpenAPI

````yaml /api-rest/openapi/openapi_knowledge_graph.json post /v1/knowledge-graph/people
openapi: 3.0.3
info:
  title: Bigdata Knowledge Graph API
  version: 1.0.0
  description: >-
    Access structured data from the Knowledge Graph to find companies, people,
    places, and other entities with detailed information.
servers:
  - url: https://api.bigdata.com/
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v1/knowledge-graph/people:
    post:
      tags:
        - People
      summary: Find by details
      description: >-
        Find people such as executives, politicians and public figures. Search
        by name or description and narrow the results by position, employer,
        nationality or gender.
      operationId: findPeople
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FindPeopleRequest'
      responses:
        '200':
          description: Successful response with people data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FindPeopleResponse'
components:
  schemas:
    FindPeopleRequest:
      type: object
      properties:
        query:
          type: string
          description: >-
            Text query to search for people by name or description. Examples:
            'Tim Cook', 'Christine Lagarde'
          example: Tim Cook
        positions:
          type: array
          items:
            type: string
          description: >-
            Positions, as published in the `position` field of results (e.g.,
            'Chief Executive Officer')
          example:
            - Chief Executive Officer
        employers:
          type: array
          items:
            type: string
          description: >-
            Employers, as published in the `employer` field of results (e.g.,
            'Apple Inc.')
          example:
            - Apple Inc.
        nationalities:
          type: array
          items:
            type: string
          description: >-
            Nationalities, as published in the `nationality` field of results
            (e.g., 'American')
          example:
            - American
        genders:
          type: array
          items:
            type: string
          description: >-
            Genders, as published in the `gender` field of results (e.g.,
            'Male', 'Female')
          example:
            - Male
      description: >-
        Request body for finding people. Each field is optional. However, you
        must provide at least one field to perform a valid search. The values a
        filter accepts can be listed with `GET
        /v1/knowledge-graph/people/values/{filter}`.
      example:
        query: Tim Cook
        employers:
          - Apple Inc.
    FindPeopleResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/Person'
          description: Array of people results
        metadata:
          type: object
          properties:
            request_id:
              type: string
              description: Unique request identifier
              example: 2a25111e-0043-4fe2-946e-668aa5af928a
            timestamp:
              type: string
              format: date-time
              description: Response timestamp
              example: '2026-07-02T13:24:45.163695+00:00'
          required:
            - request_id
            - timestamp
        usage:
          $ref: '#/components/schemas/Usage'
          description: >-
            Optional. Present for token-billing accounts only. Reports the
            number of tokens consumed by this request.
      required:
        - results
        - metadata
      description: Response containing people results and metadata
    Person:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier in the Knowledge Graph
          example: 6BD43B
        name:
          type: string
          description: Name
          example: Tim Cook
        description:
          type: string
          description: Description and overview
          example: >-
            Timothy Donald Cook (born on the 1st of October 1960) is an American
            business executive who has been serving as the CEO of Apple Inc.
            since August 2011, succeeding Steve Jobs.
        position:
          type: string
          description: Primary position held
          example: Chief Executive Officer
        employer:
          type: string
          description: Primary employer
          example: Apple Inc.
        nationality:
          type: string
          description: Nationality
          example: American
        gender:
          type: string
          description: Gender
          example: Male
        short_description:
          type: string
          description: One-line description
          example: CEO of Apple
      required:
        - id
        - name
      description: Person entity with detailed information
    Usage:
      type: object
      properties:
        knowledge_graph_tokens:
          type: integer
          description: Number of tokens consumed by this request.
          example: 1
      required:
        - knowledge_graph_tokens
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````