---
title: "Search for data visualizations using natural language. Ask any question about finance, economics, demographics, sports, politics, climate, or health and get back interactive knowledge cards with charts, data, and source attribution. Example: {\"inputs\": {\"text\": \"NVIDIA vs AMD revenue since 2018\"}}. Returns cards with title, chart image URL, interactive webpage URL, embeddable URL, data description, and source information."
method: POST
path: "/tako/v1/knowledge_search"
tags: ["Tako"]
---

# Search for data visualizations using natural language. Ask any question about finance, economics, demographics, sports, politics, climate, or health and get back interactive knowledge cards with charts, data, and source attribution. Example: {"inputs": {"text": "NVIDIA vs AMD revenue since 2018"}}. Returns cards with title, chart image URL, interactive webpage URL, embeddable URL, data description, and source information.

`POST /tako/v1/knowledge_search`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/tako/v1/knowledge_search`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/tako/v1/knowledge_search/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `inputs` object, required: Object with "text" (string, required): your natural language query (e.g. "US GDP growth 2020-2024", "Tesla vs Ford market cap"). Optional "search_effort" (string): "fast" for quick results, "medium" for balanced, "deep" for thorough research, "auto" to let Tako decide.
  - `source_indexes` string[]: Array of source index strings to search, in priority order. Options: "tako" (curated financial/economic data from S&P Global, World Bank, etc.), "web" (web sources), "tako_deep_v2" (deeper research). Default: ["tako"].
  - `country_code` string: ISO 3166-1 alpha-2 country code to localize results (e.g. "US", "GB", "DE"). Default: "US".
  - `locale` string: Locale string (e.g. "en-US", "de-DE"). Default: "en-US".
  - `output_settings` object: Optional. Set {"knowledge_card_settings": {"image_dark_mode": true}} to get dark-mode chart images.

## Response `200`

Successful response

## Other responses

- `402`: Payment Required (x402 / MPP / np)

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added required request body

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/tako/v1/knowledge_search/post.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/fc2e1d26c8eb?raw)