Skip to main content
POST
/
v1
/
thin_viz
/
search_people
cURL
curl --request POST \
  --url https://trytako.com/api/v1/thin_viz/search_people/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "query": "<string>",
  "num_results": 5,
  "exa_api_key": "<string>"
}
'
[
  {
    "card_id": "jLmsqH4NfXFLqhWnZqhM",
    "title": "Nvidia, Advanced Micro Devices - Full Time Employees",
    "description": "This is a time series bar chart showing 2 series between 12:00AM UTC-04:00 on 04/01/2013 and 08:55PM UTC on 04/30/2025. Nvidia Full Time Employees latest value was at 12:00AM UTC on 12-31-2024, and had a final value of 36.0K Employees, or 308.72% growth since 12:00AM UTC on 12-31-2013, with a maximum value of 36.0K Employees at 12:00AM UTC on 12-31-2024 and a minimum value of 8.81K Employees at 12:00AM UTC on 12-31-2013; Advanced Micro Devices Full Time Employees latest value was at 12:00AM UTC on 12-31-2024, and had a final value of 28.0K Employees, or 162.39% growth since 12:00AM UTC on 12-31-2013, with a maximum value of 28.0K Employees at 12:00AM UTC on 12-31-2024 and a minimum value of 8.2K Employees at 12:00AM UTC on 12-31-2016. The source of the data is S&P Global. S&P Global is a US-based financial data and analytics company that provides products and services to the financial industry.",
    "webpage_url": "https://trytako.com/card/jLmsqH4NfXFLqhWnZqhM/",
    "image_url": "https://trytako.com/api/v1/image/jLmsqH4NfXFLqhWnZqhM/",
    "embed_url": "https://trytako.com/embed/jLmsqH4NfXFLqhWnZqhM/",
    "sources": [
      {
        "source_name": "S&P Global",
        "source_description": "S&P Global is a US-based financial data and analytics company that provides products and services to the financial industry.",
        "source_index": "tako",
        "url": "https://xignite.com"
      }
    ],
    "methodologies": [
      {
        "methodology_name": "Where the Data Comes From - S&P Global",
        "methodology_description": "The financial metrics are collected from S&P Global, where information is sourced from original regulatory filings, press releases, and subsequent restatements. Data points, including over 5,000 financial, supplemental, segment, ratio, and industry-specific items, are standardized across over 180,000 companies to ensure consistency and comparability across different reporting formats. This comprehensive and methodical process enables robust historical analysis and back-testing by seamlessly integrating diverse financial datasets while preserving the granularity of the original reports."
      }
    ],
    "source_indexes": [
      "tako"
    ],
    "card_type": "company",
    "data_url": "<string>",
    "relevance": "High",
    "visualization_data": {
      "data": [
        {
          "x": "2013",
          "y": 10000
        },
        {
          "x": "2014",
          "y": 20000
        }
      ],
      "viz_config": {
        "title": "Nvidia, Advanced Micro Devices - Full Time Employees"
      }
    },
    "ideal_viz_decisions": [
      {
        "property_path": "<string>",
        "reason": "<string>",
        "property_path_display_name": "Y-axis tick color"
      }
    ]
  }
]

​
Notes

  • To authenticate, you’ll need a Tako API key. It’s best practice to store it as an environment variable to avoid hardcoding sensitive credentials in your code.
  • Searches the Exa person search API and creates persisted person cards with career history, education, and profile information.
  • Returns an array of knowledge cards — one per Exa search result. Each card has embed_url, image_url, and webpage_url for embedding.
  • Returns an empty array [] if no matching people are found.

​
Credit Cost

The credit cost depends on which Exa API key is used:
Key SourceCost
Your own key (via exa_api_key field or stored on your account)1 credit
Tako’s built-in key (no key provided)100 credits

​
Exa Key Resolution Order

  1. Request body exa_api_key — per-request override (highest priority)
  2. Stored key — your exa_api_key saved on your account
  3. Tako’s key — built-in fallback (100 credits)

​
Example

import requests
import os

response = requests.post(
    "https://api.trytako.com/api/v1/thin_viz/search_people/",
    headers={"X-API-Key": os.environ["TAKO_API_KEY"]},
    json={
        "query": "Jensen Huang NVIDIA CEO",
        "num_results": 3,
        "exa_api_key": os.environ.get("EXA_API_KEY"),  # Optional: use your own key for 1 credit
    },
)

cards = response.json()
for card in cards:
    print(f"{card['title']}: {card['webpage_url']}")

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
query
string
required

Person name, optionally with context like company or role to disambiguate (e.g., "Jensen Huang NVIDIA CEO")

Minimum string length: 1
​
num_results
integer
default:5

Number of Exa results to fetch and create cards for

Required range: 1 <= x <= 25
​
exa_api_key
string | null

Per-request Exa API key override. If provided, bypasses stored key and Tako's key. Using your own key costs 1 credit instead of 100.

Response

Array of created person cards (empty array if no results)

​
card_id
string | null
required

The unique ID of the knowledge card

Example:

"jLmsqH4NfXFLqhWnZqhM"

​
title
string | null
required

The title of the knowledge card

Example:

"Nvidia, Advanced Micro Devices - Full Time Employees"

​
description
string | null
required

The description of the knowledge card

Example:

"This is a time series bar chart showing 2 series between 12:00AM UTC-04:00 on 04/01/2013 and 08:55PM UTC on 04/30/2025. Nvidia Full Time Employees latest value was at 12:00AM UTC on 12-31-2024, and had a final value of 36.0K Employees, or 308.72% growth since 12:00AM UTC on 12-31-2013, with a maximum value of 36.0K Employees at 12:00AM UTC on 12-31-2024 and a minimum value of 8.81K Employees at 12:00AM UTC on 12-31-2013; Advanced Micro Devices Full Time Employees latest value was at 12:00AM UTC on 12-31-2024, and had a final value of 28.0K Employees, or 162.39% growth since 12:00AM UTC on 12-31-2013, with a maximum value of 28.0K Employees at 12:00AM UTC on 12-31-2024 and a minimum value of 8.2K Employees at 12:00AM UTC on 12-31-2016. The source of the data is S&P Global. S&P Global is a US-based financial data and analytics company that provides products and services to the financial industry."

​
webpage_url
string | null
required

URL of a webpage hosting the interactive knowledge card

Example:

"https://trytako.com/card/jLmsqH4NfXFLqhWnZqhM/"

​
image_url
string | null
required

URL of a static image of the knowledge card

Example:

"https://trytako.com/api/v1/image/jLmsqH4NfXFLqhWnZqhM/"

​
embed_url
string | null
required

URL of an embeddable iframe of the knowledge card

Example:

"https://trytako.com/embed/jLmsqH4NfXFLqhWnZqhM/"

​
sources
KnowledgeCardSource · object[] | null
required

The sources of the knowledge card

​
methodologies
KnowledgeCardMethodology · object[] | null
required

The methodologies of the knowledge card

​
source_indexes
(enum<string> | KnowledgeSearchSourceIndexSegment · object)[] | null
required

The source indexes of the knowledge card

Available options:
tako,
web,
connected_data,
tako_deep_v2
​
card_type
string | null
required

The type of card

Example:

"company"

​
data_url
string | null
required

URL of downloadable data of the knowledge card. This needs to be enabled on an account level. Contact support to enable this feature.

​
relevance
enum<string> | null
required

How relevant this knowledge card is to the search query

Available options:
High,
Medium,
Low
Example:

"High"

​
visualization_data
Visualization Data · object
required

The visualization data of the knowledge card

Example:
{
  "data": [
    { "x": "2013", "y": 10000 },
    { "x": "2014", "y": 20000 }
  ],
  "viz_config": {
    "title": "Nvidia, Advanced Micro Devices - Full Time Employees"
  }
}
​
ideal_viz_decisions
IdealVizDecision · object[] | null
deprecated

Decisions made by Tako's ideal viz logic when constructing this visualization. DEPRECATED: Use ChartConfig.viz_decisions for the new structured system with override support.