Skip to main content
POST
/
v1
/
thin_viz
/
create
cURL
curl --request POST \
  --url https://tako.com/api/v1/thin_viz/create/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "components": [
    {
      "config": {},
      "component_variant": "<string>"
    }
  ],
  "title": "<string>",
  "description": "<string>",
  "source": "<string>",
  "image_ttl_minutes": 720
}
'
{
  "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://tako.com/card/jLmsqH4NfXFLqhWnZqhM/",
  "image_url": "https://tako.com/api/v1/image/jLmsqH4NfXFLqhWnZqhM/",
  "embed_url": "https://tako.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",
      "source_text": "The Devil Wears Prada 2 has grossed about $548 million worldwide."
    }
  ],
  "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": [],
  "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.
  • Creates a card in a single API call with full component configurations. No schema step is required.
  • The response includes embed_url, image_url, and webpage_url for embedding the card.
  • If no title is provided, it falls back to the title from the first header component, or defaults to “Card”.
  • See the Thin-Viz Guide for full examples and available component types.
  • For large datasets (>1MB): Use gzip compression to send payloads up to 10x larger.
  • Preview images for ZDR cards: Set image_ttl_minutes (1–1440) to make a temporary preview image available via image_url. The image can be downloaded on demand with query params (dark_mode, width, height, hideFooter) until the TTL expires, after which the endpoint returns 410 Gone.

Authorizations

​
X-API-Key
string
header
required

Body

application/json

Request model for creating a card directly with components.

​
components
ComponentConfig · object[]
required

Full component configurations

​
title
string | null

Card title (falls back to header component title if not provided)

​
description
string | null

Card description

​
source
string | null

Data source attribution (displayed in footer)

​
image_ttl_minutes
integer | null

Minutes to keep preview image available for download (ZDR only). Min 1, max 1440 (24h). When set on a ZDR card, a temporary preview image is generated and available for download until the TTL expires. Ignored for non-ZDR cards.

Required range: 1 <= x <= 1440

Response

Created knowledge card

​
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://tako.com/card/jLmsqH4NfXFLqhWnZqhM/"

​
image_url
string | null
required

URL of a static image of the knowledge card

Example:

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

​
embed_url
string | null
required

URL of an embeddable iframe of the knowledge card

Example:

"https://tako.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.