{"uid":"cap_1o1sMbjza3EHzSZjq7M0s","slug":"tako-visualize-ecb5b111","name":"Tako Visualize","description":"Visualize your own data (inline CSV); does not search Tako's data","url":"https://tako.com/api/mpp/v1/visualize?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"VisualizeRequest","properties":{"csv":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Csv","default":null,"description":"List of serialized CSV strings to visualize"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query","default":null,"description":"Query with instructions to visualize the dataset"},"file_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Id","default":null,"deprecated":true,"description":"The file id of the dataset to visualize. This is deprecated and will be removed in the future. Use `file_ids` instead."},"file_ids":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"array","items":{"type":"object","title":"KnowledgeSearchFileSource","required":["file_id"],"properties":{"file_id":{"type":"string","title":"File Id"},"segment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Segment Id","default":null},"file_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Context","default":null},"ontology_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ontology Context","default":null},"private_index_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Private Index Id","default":null}}}}],"title":"File Ids","default":[],"description":"The file ids of the datasets to visualize"},"segment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Segment Id","default":null,"description":"The segment id of the dataset to visualize"},"output_settings":{"anyOf":[{"type":"object","title":"KnowledgeSearchRequestOutputSettings","required":["knowledge_card_settings"],"properties":{"force_refresh":{"type":"boolean","title":"Force Refresh","default":false,"description":"Instant mode only. When false (default), instant returns existing cached embeds as-is and never retrieves, updates, or creates (fastest path). When true, instant retrieves data for missing or stale embeds and creates or refreshes their static embeds — slower for those — but embeds already fresh (within the refresh cadence) are served as-is, not re-retrieved or updated."},"knowledge_card_settings":{"type":"object","title":"KnowledgeCardOutputSettings","properties":{"image_dark_mode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Image Dark Mode","default":null,"description":"Whether to make the knowledge card image dark mode"}}}}},{"type":"null"}],"default":null,"description":"Settings for controlling outputs of the knowledge search request"},"viz_component_type":{"anyOf":[{"enum":["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"],"type":"string","title":"UserRequestedVizComponentType"},{"type":"null"}],"default":null,"description":"The type of visualization component to use"},"connected_private_index_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connected Private Index Id","default":null,"description":"The connected private index id of the dataset to visualize"}}},"responseSchema":{"type":"object","title":"KnowledgeSearchResults","properties":{"outputs":{"anyOf":[{"type":"object","title":"KnowledgeSearchOutputs","properties":{"answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer","default":null},"sources":{"anyOf":[{"type":"array","items":{"type":"object","title":"KnowledgeCardSource","required":["source_name","source_description","source_index","url"],"properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","examples":["https://xignite.com","https://stats.com"],"description":"The URL of the source"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name","examples":["S&P Global","The World Bank"],"description":"The name of the source"},"source_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Text","default":null,"examples":["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."],"description":"Raw excerpt(s) retrieved from the source page — the unmodified web content the answer was grounded in, NOT the synthesized answer. Populated for WEB sources; null for sources that don't carry an extracted excerpt (e.g. TAKO sources)."},"source_index":{"anyOf":[{"$ref":"#/components/schemas/CardSourceIndex"},{"$ref":"#/components/schemas/CardSourceIndexSegment"},{"$ref":"#/components/schemas/CardSourcePrivateIndex"}],"title":"Source Index","examples":["tako","web","connected_data",{"index_type":"connected_data","segment_id":"123"},{"index_type":"connected_data","segment_id":"123","private_index_id":"123"}],"description":"The index of the source"},"source_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Description","examples":["S&P Global is a US-based financial data and analytics company serving investment professionals."],"description":"A concise, one-sentence description of the source (who it is and what data it provides). Falls back to the full source description when no concise summary is available."}}}},{"type":"null"}],"title":"Sources","default":null,"description":"Top-level source citations for the answer. Populated when the WEB source index returns a synthesized text answer with supporting URLs."},"web_results":{"anyOf":[{"type":"array","items":{"type":"object","title":"WebResult","required":["title","url"],"properties":{"url":{"type":"string","title":"Url","description":"URL of the web page."},"title":{"type":"string","title":"Title","description":"Title of the web page."},"content":{"anyOf":[{"$ref":"#/components/schemas/ResultContent"},{"type":"null"}],"default":null,"description":"Downloadable content descriptor for this result, fetched via the Contents endpoint. Web results are always downloadable as text. None for callers that do not populate it."},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet","default":null,"description":"Excerpt(s) from the page that matched the query."},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name","default":null,"description":"Publisher or domain name, when Tako can extract it from the URL."},"publish_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish Date","default":null,"description":"Publication date of the page, when available."}},"description":"A single raw web search result from the WEB source index.\n\nDistinct from `KnowledgeCardSource` (a citation inside a synthesized\nanswer) and `KnowledgeCard` (a Tako visualization). Web results are\nraw retrieval output — title, URL, optional snippet. They do not depend\non any LLM synthesis that may also happen over them."}},{"type":"null"}],"title":"Web Results","default":null,"description":"Raw web search results from the WEB source index, when requested. Independent of `answer`/`sources` — these are the raw retrieval output before any LLM synthesis."},"knowledge_cards":{"anyOf":[{"type":"array","items":{"type":"object","title":"KnowledgeCard","required":["card_id","title","description","webpage_url","image_url","embed_url","sources","methodologies","source_indexes","card_type","data_url","relevance","visualization_data"],"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","examples":["Nvidia, Advanced Micro Devices - Revenue"],"description":"The title of the knowledge card"},"card_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Id","examples":["jLmsqH4NfXFLqhWnZqhM"],"description":"The unique ID of the knowledge card"},"sources":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCardSource"}},{"type":"null"}],"title":"Sources","description":"The sources of the knowledge card"},"data_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Url","description":"URL of downloadable data of the knowledge card. This needs to be enabled on an account level. Contact support to enable this feature."},"card_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Card Type","examples":["company","chart","table","text"],"description":"The type of card"},"embed_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Embed Url","examples":["https://tako.com/embed/jLmsqH4NfXFLqhWnZqhM/"],"description":"URL of an embeddable iframe of the knowledge card"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","examples":["https://tako.com/api/v1/image/jLmsqH4NfXFLqhWnZqhM/"],"description":"URL of a static image of the knowledge card"},"relevance":{"anyOf":[{"$ref":"#/components/schemas/KnowledgeCardRelevance"},{"type":"null"}],"examples":["High","Medium","Low"],"description":"How relevant this knowledge card is to the search query"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","examples":["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."],"description":"The description of the knowledge card"},"webpage_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Webpage Url","examples":["https://tako.com/card/jLmsqH4NfXFLqhWnZqhM/"],"description":"URL of a webpage hosting the interactive knowledge card"},"methodologies":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCardMethodology"}},{"type":"null"}],"title":"Methodologies","description":"The methodologies of the knowledge card"},"source_indexes":{"anyOf":[{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/CardSourceIndex"},{"$ref":"#/components/schemas/CardSourceIndexSegment"}]}},{"type":"null"}],"title":"Source Indexes","description":"The source indexes of the knowledge card"},"visualization_data":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Visualization Data","examples":[{"data":[{"x":"2013","y":10000},{"x":"2014","y":20000}],"viz_config":{"title":"Nvidia, Advanced Micro Devices - Full Time Employees"}}],"description":"The visualization data of the knowledge card. Null when a data provider for the card does not permit raw data export, and null when Tako cannot confirm the card's data sources. The card remains renderable via embed_url."},"ideal_viz_decisions":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/IdealVizDecision"}},{"type":"null"}],"title":"Ideal Viz Decisions","default":null,"deprecated":true,"description":"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."},"semantic_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Semantic Description","default":null,"examples":["Quarterly revenue for Apple Inc., in USD, 2019 to 2024. Source: S&P Global."],"description":"A lightweight, data-free description of the card's subject (metric, entities, time span, source). Present even when full data is deferred, so consumers can judge relevance before fetching the chart."}}}},{"type":"null"}],"title":"Knowledge Cards","default":null}}},{"type":"null"}],"default":null},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","default":null}}},"example":null,"exampleRequest":null,"tags":["data","visualization","charts","research","search","answers","agents","reports","datasets","analytics","ai"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.036667","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.036667","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mGUyXq-w7GUThGIhH9MWF","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.036667","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Tako","brandSlug":"tako","brandBaseUrl":"https://tako.com","brandDocsUrl":"https://tako.com","whatItDoes":"Generates a data visualization (chart) from a natural language search query against datasets","exampleAgentPrompt":"Show me a chart of global electric vehicle adoption by country over the last 5 years — pull the data automatically and visualize it.","exampleUseCases":null,"resultDescription":"A rendered chart or visualization (ThinViz card) derived from data matching the search query, ready to display or embed in a report.","failureModes":["No relevant dataset found for the query — returns empty or error response","Ambiguous query produces unexpected dataset match","Rate limit or payment failure for $0.04 USDC call","Visualization cannot be rendered due to insufficient or malformed data"],"whenToPreferThis":"Use this endpoint when you need a quick, single-step chart generated from a natural language data query — it combines dataset search and visualization in one call. Prefer over the 'Fast' or 'Deep' search endpoints when you want a visual output rather than raw data, and over 'Generate' when you don't need a full multi-chart research report.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:34:48.296Z","isFirstParty":false,"canonicalSlug":"tako-visualize-ecb5b111"}