# Tako Visualize

> Tako Visualize is a paid API for AI agents from Tako at tako.com, paid per call via MPP, $0.04/call, status unknown (last checked 2026-10-11).

Generates a data visualization (chart) from a natural language search query against datasets

## Facts

- Endpoint: POST https://tako.com/api/mpp/v1/visualize?utm_source=zero.xyz
- Price: $0.04/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Tako
- Docs: https://tako.com
- Website: https://tako.com
- Tags: data, visualization, charts, research, search, answers, agents, reports, datasets, analytics, ai
- Canonical page: https://www.zero.xyz/c/tako-visualize-ecb5b111
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1o1sMbjza3EHzSZjq7M0s

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tako-visualize-ecb5b111 -d '<json body>'
```

Example prompt: Show me a chart of global electric vehicle adoption by country over the last 5 years — pull the data automatically and visualize it.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

A rendered chart or visualization (ThinViz card) derived from data matching the search query, ready to display or embed in a report.

## Request schema (JSON Schema)

```json
{
 "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": [

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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"
             },
             {
              "$re
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tako-visualize-ecb5b111/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tako.com](https://www.zero.xyz/host/tako.com/llms.txt)