Visualize your own data (inline CSV); does not search Tako's data

Changed on
post/api/mpp/v1/visualize

Request

  • Base URL
    https://tako.com
  • URL
    https://tako.com/api/mpp/v1/visualize
  • Auth
    none declared

Request body

csvstring[] nullable

List of serialized CSV strings to visualize

file_idstring nullable

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

querystring nullable

Query with instructions to visualize the dataset

viz_component_type'bar' | 'grouped_bar' | 'stacked_bar' | 'timeseries' | 'area_timeseries' | 'stacked_area_timeseries' | 'pie' | 'choropleth' | 'map' | 'bubble_map' | 'scatter' | 'boxplot' | 'heatmap' | 'timeline' | 'waterfall' | 'histogram' | 'table' | 'treemap' | 'top_level_metric'
segment_idstring nullable

The segment id of the dataset to visualize

connected_private_index_idstring nullable

The connected private index id of the dataset to visualize

Response

Visualization results for the given data.

request_idstring nullable

Example response

{
  "outputs": {
    "knowledge_cards": [
      {
        "card_id": "jLmsqH4NfXFLqhWnZqhM",
        "title": "Nvidia, Advanced Micro Devices - Revenue",
        "description": "Nvidia Revenue's latest value was $130.5B on Dec 31, 2024, up 2,114.0% since Dec 31, 2013, with a maximum of $130.5B on Dec 31, 2024 and a minimum of $4.13B on Dec 31, 2013; Advanced Micro Devices Revenue's latest value was $25.8B on Dec 31, 2024, up 328.0% since Dec 31, 2013, with a maximum of $25.8B on Dec 31, 2024 and a minimum of $5.30B on Dec 31, 2013. Annual data from Dec 31, 2013 to Dec 31, 2024.",
        "semantic_description": "Quarterly revenue for Apple Inc., in USD, 2019 to 2024. Source: S&P Global.",
        "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 serving investment professionals.",
            "source_index": {
              "segment_id": "123"
            },
            "url": "https://xignite.com",
            "source_text": "Domestic (28.1%) $154,061,981 | International (71.9%) $394,144,531 | Worldwide $548,206,512. Release Date Nov 7, 2025. Distributor 20th Century Studios."
          }
        ],
        "methodologies": [
          {
            "methodology_name": "Where the Data Comes From - S&P Global",
            "methodology_description": "Financial metrics standardized by S&P Global from company regulatory filings, press releases, and restatements."
          }
        ],
        "source_indexes": [
          {
            "segment_id": "123"
          }
        ],
        "card_type": "company",
        "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": "scales.y.ticks.color",
            "property_path_display_name": "Y-axis tick color",
            "reason": "Using bar instead of line because there are too few data points"
          }
        ]
      }
    ],
    "sources": [
      {
        "source_name": "S&P Global",
        "source_description": "S&P Global is a US-based financial data and analytics company serving investment professionals.",
        "source_index": {
          "segment_id": "123"
        },
        "url": "https://xignite.com",
        "source_text": "Domestic (28.1%) $154,061,981 | International (71.9%) $394,144,531 | Worldwide $548,206,512. Release Date Nov 7, 2025. Distributor 20th Century Studios."
      }
    ]
  }
}

Changes

    • breaking

      response property outputs/anyOf[subschema #1: KnowledgeSearchOutputs]/web_results/anyOf[subschema #1]/items/content/anyOf[subschema #1: ResultContent]/dataset/anyOf[subschema #1: TakoDataset]/rows/items/items/ list-of-types was widened by adding types array to media type application/json of response 200

    • breaking

      response property outputs/anyOf[subschema #1: KnowledgeSearchOutputs]/web_results/anyOf[subschema #1]/items/content/anyOf[subschema #1: ResultContent]/records/anyOf[subschema #1]/items/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 200

    • warning

      added the new array enum value to the /////////// response property for the response status

    • warning

      added the new array enum value to the /////////// response property for the response status

    • warning

      added the new BUDGET_EXCEEDED enum value to the / response property for the response status

    • warning

      added the new BUDGET_EXCEEDED enum value to the / response property for the response status

    • warning

      added the new BUDGET_EXCEEDED enum value to the response property for the response status

    • info

      added the non-success response with the status