> ## 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 People

Find people by details returns a list of people that matched the query parameter.

The value can match with the person's name, or description. Results can be narrowed with the `positions`, `employers`, `nationalities` and `genders` filters, which take the values the results publish in `position`, `employer`, `nationality` and `gender`. Use [Filter Values](/getting-started/knowledge_graph/filter_values) to list the values each one accepts.

Once you have the IDs, you can use them to filter your search queries with an [Entity query filter](../search/query_filters#entity).

<CodeGroup>
  ```bash API highlight={1,5-6} theme={null}
  curl -X POST 'https://api.bigdata.com/v1/knowledge-graph/people' \
    -H 'Content-Type: application/json' \
    -H 'X-API-KEY: <your-api-key>' \
    --data '{
    "query": "Tim Cook",
    "employers": ["Apple Inc."]
  }'
  ```

  ```python Python SDK theme={null}
  from dotenv import load_dotenv
  from bigdata_client import Bigdata
  import os

  load_dotenv()

  # Initialize the Bigdata API
  username = os.environ.get("BIGDATA_USERNAME")
  password = os.environ.get("BIGDATA_PASSWORD")
  bigdata = Bigdata(username, password)

  results = bigdata.knowledge_graph.find_people("Obama")

  for person in results:
      print(f"Entity ID: {person.id}")
      print(f"Person Name: {person.name}")
      print(f"Nationality: {person.nationality}")  
      print(f"Description: {person.description}\n")
  ```
</CodeGroup>

Output:

<CodeGroup>
  ```json API theme={null}
  {
    "results": [
      {
        "id": "6BD43B",
        "name": "Tim Cook",
        "description": "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. He is known for his leadership in expanding Apple's product line and services.",
        "position": "Chief Executive Officer",
        "employer": "Apple Inc.",
        "nationality": "American",
        "gender": "Male",
        "short_description": "CEO of Apple"
      },
  ...
    ],
    "metadata": {
      "request_id": "2a25111e-0043-4fe2-946e-668aa5af928a",
      "timestamp": "2026-07-02T13:24:45.163695+00:00"
    }
  }
  ```

  ```txt Python SDK theme={null}
  Entity ID: A1F9FC
  Person Name: Barack Obama
  Nationality: American
  Description: Barack Hussein Obama II (born August 4, 1961) is an American politician who served as the 44th President of the United States from 2009 to 2017, and the first African American to hold the office. He implemented numerous economic stimulus measures and signed into law landmark healthcare reform known as the Affordable Care Act.

  Entity ID: 2DED74
  Person Name: Michelle Obama
  Nationality: American
  Description: Michelle Obama (born January 17, 1964) is an American lawyer, university administrator, and writer, who served as the First Lady of the United States from 2009 to 2017. She is known for her advocacy on issues such as education, health, and military families, as well as her efforts to promote healthy eating and physical activity.

  Entity ID: 6222B7
  Person Name: Malia Ann Obama
  Nationality: American
  Description: Malia Ann Obama (born July 4, 1998) is the daughter of former President Barack Obama. She is an American student and public figure, known for her activism and advocacy work.

  ...
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.