Find by details

Find by details

curl --request POST \
  --url https://api.bigdata.com/v1/knowledge-graph/people \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "Tim Cook",
  "employers": [
    "Apple Inc."
  ]
}
'

import requests

url = "https://api.bigdata.com/v1/knowledge-graph/people"

payload = {
    "query": "Tim Cook",
    "employers": ["Apple Inc."]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'Tim Cook', employers: ['Apple Inc.']})
};

fetch('https://api.bigdata.com/v1/knowledge-graph/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bigdata.com/v1/knowledge-graph/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'Tim Cook',
    'employers' => [
        'Apple Inc.'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigdata.com/v1/knowledge-graph/people"

	payload := strings.NewReader("{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/knowledge-graph/people")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/knowledge-graph/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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.",
      "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"
  },
  "usage": {
    "knowledge_graph_tokens": 1
  }
}

POST

knowledge-graph

people

Find by details

curl --request POST \
  --url https://api.bigdata.com/v1/knowledge-graph/people \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "query": "Tim Cook",
  "employers": [
    "Apple Inc."
  ]
}
'

import requests

url = "https://api.bigdata.com/v1/knowledge-graph/people"

payload = {
    "query": "Tim Cook",
    "employers": ["Apple Inc."]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'Tim Cook', employers: ['Apple Inc.']})
};

fetch('https://api.bigdata.com/v1/knowledge-graph/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bigdata.com/v1/knowledge-graph/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'Tim Cook',
    'employers' => [
        'Apple Inc.'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigdata.com/v1/knowledge-graph/people"

	payload := strings.NewReader("{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bigdata.com/v1/knowledge-graph/people")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bigdata.com/v1/knowledge-graph/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"Tim Cook\",\n  \"employers\": [\n    \"Apple Inc.\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "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.",
      "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"
  },
  "usage": {
    "knowledge_graph_tokens": 1
  }
}

Authorizations

X-API-KEY

string

header

required

Body

application/json

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

query

string

Text query to search for people by name or description. Examples: 'Tim Cook', 'Christine Lagarde'

Example:

"Tim Cook"

positions

string[]

Positions, as published in the position field of results (e.g., 'Chief Executive Officer')

Example:

["Chief Executive Officer"]

employers

string[]

Employers, as published in the employer field of results (e.g., 'Apple Inc.')

Example:

["Apple Inc."]

nationalities

string[]

Nationalities, as published in the nationality field of results (e.g., 'American')

Example:

["American"]

genders

string[]

Genders, as published in the gender field of results (e.g., 'Male', 'Female')

Example:

["Male"]

Response

200 - application/json

Successful response with people data

Response containing people results and metadata

results

object[]

required

Array of people results

Show child attributes

metadata

object

required

Show child attributes

usage

object

Optional. Present for token-billing accounts only. Reports the number of tokens consumed by this request.

Show child attributes

API

Knowledge Graph

Search Service

Watchlists

Monitors

Research Service

Content

Structured Data

Subscription

SDK

Authorizations

Body

Response