Migrate from Tako

typesearch speaks Tako Search v3 for web results, in the same format. With the official SDK, migrating is two lines.

from tako import Configuration, SearchRequest
from tako.lib import Tako

config = Configuration(host="https://api.typesearch.ai/compat/tako/api")  # before: Configuration()
config.api_key["apiKey"] = TYPESEARCH_API_KEY                               # before: TAKO_API_KEY

r = Tako(config).search(SearchRequest.from_dict({
    "query": "Boca Juniors",
    "sources": {"web": {"count": 10, "category": "sports"}},
}))

Partial, on purpose

Tako returns two things: data cards (charts built from licensed datasets) and web results. Through this compatible endpoint, web results come back complete and in the same format. Data cards come back empty (cards: []), with unsupported:data_cards in X-Compat-Warnings; a request that only asks for cards returns empty without searching or billing.

Chart cards

typesearch makes chart cards of its own with POST /v1/charts, and with the MCP server's create_chart tool. Ask in plain words and you get the chart, the key figures, a title that states the finding, an embed, a PNG and an SVG. They are built from the news (coverage, share of voice, tone, outlets, timelines, and the figures articles publish, found verbatim) or from your own data, with the source of every value. To replace Tako's cards, call it next to the compatible search:

curl https://api.typesearch.ai/v1/charts \
  -H "Authorization: Bearer $TYPESEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Boca Juniors coverage" }'

The response carries the card's embed_url, image_url and svg_url, the data drawn in chart, and sources. From a query it costs its search plus $0.50 per 1,000 charts, from $1.50 per 1,000 in all; for reference, Tako's Search, which returns chart cards, lists $7 per 1,000.

Parameters

Tako	On typesearch
`effort`	`instant` → `ultra` · `fast` → `fast` · `deep` → `deep`.
`sources.web.count`	Same, 1–20.
`sources.web.category`	`sports` → the sports section · `finance` → economy · `news` → everything.
`include_domains`, `exclude_domains`	Same.
`published_after`, `published_before`	Same.
`highlights`	Verbatim excerpts from the articles that were read.
`include_contents`	`content` comes back `null` (`limited:content`): excerpts only.
`output_settings.flat_results`, `force_refresh`	Same.

Errors keep Tako’s format: { error_message, error_type }.

Our extras

Add a typesearch field to the JSON body for tone, essentials, a mode or a cost cap; it comes back in a typesearch field of the response. For everything else, the native API and our SDKs expose all of it.

What stays with Tako

Tako's cards draw on licensed datasets (markets, economics, sports statistics) that we don't have: our charts come from what the news publishes and from your data. If your product depends on those datasets, or on answers synthesized by the API itself, keep those on Tako and move your web search here.