Skip to main content
POST
/
v1
/
beta
/
visualize
cURL
curl --request POST \
  --url https://trytako.com/api/v1/beta/visualize \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "csv": [
    "<string>"
  ],
  "file_id": "<string>",
  "query": "<string>",
  "debug": false,
  "file_ids": [
    "<string>"
  ],
  "viz_component_type": "bar",
  "output_settings": {
    "knowledge_card_settings": {
      "image_dark_mode": true
    }
  },
  "model": "o3",
  "segment_id": "<string>",
  "connected_private_index_id": "<string>",
  "extra_params": "<string>"
}'
{
  "outputs": {
    "knowledge_cards": [
      {
        "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>",
        "confidence": "High",
        "visualization_data": {
          "data": [
            {
              "x": "2013",
              "y": 10000
            },
            {
              "x": "2014",
              "y": 20000
            }
          ],
          "viz_config": {
            "title": "Nvidia, Advanced Micro Devices - Full Time Employees"
          }
        }
      }
    ],
    "answer": "<string>"
  },
  "request_id": "<string>"
}

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.

Authorizations

X-API-Key
string
header
required

Body

application/json
csv
string[] | null

List of serialized CSV strings to visualize

file_id
string | null
deprecated

The file id of the dataset to visualize. This is deprecated and will be removed in the future. Use file_ids instead.

query
string | null

Query with instructions to visualize the dataset

debug
boolean
default:false

Whether to return debug information

file_ids

The file ids of the datasets to visualize

viz_component_type
enum<string> | null

The type of visualization component to use

Available options:
bar,
grouped_bar,
stacked_bar,
timeseries,
pie,
choropleth,
scatter,
boxplot,
heatmap,
timeline,
waterfall,
histogram,
table
output_settings
object | null

Settings for controlling outputs of the knowledge search request

model
enum<string> | null

The model to use for the visualization

Available options:
o3,
o4-mini,
gpt-5-mini,
qwen-3-32b,
llama-3.3-70b,
qwen-3-coder-480b,
qwen-3-235b-a22b-instruct-2507,
qwen-3-235b-a22b-thinking-2507,
gpt-oss-120b
segment_id
string | null

The segment id of the dataset to visualize

connected_private_index_id
string | null

The connected private index id of the dataset to visualize

extra_params
string | null

Extra parameters to pass to the visualization

Response

List of knowledge search results

outputs
object | null
request_id
string | null
I