ORorthogonal
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.

Changed on
post/tako/v1/knowledge_search

Request

Request body

inputsobject 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_indexesstring[]

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_codestring

ISO 3166-1 alpha-2 country code to localize results (e.g. "US", "GB", "DE"). Default: "US".

localestring

Locale string (e.g. "en-US", "de-DE"). Default: "en-US".

output_settingsobject

Optional. Set {"knowledge_card_settings": {"image_dark_mode": true}} to get dark-mode chart images.

Response

Successful response

Changes