Migrar desde Tako

typesearch habla Tako Search v3 para los resultados web, con el mismo formato. Con el SDK oficial, migrar son dos líneas.

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

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

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

Parcial, a propósito

Tako devuelve dos cosas: tarjetas de datos (gráficos armados con datasets licenciados) y resultados web. En este endpoint compatible, los resultados web vuelven completos y con el mismo formato. Las tarjetas vuelven vacías (cards: []), con unsupported:data_cards en X-Compat-Warnings; un pedido que sólo pide tarjetas responde vacío sin buscar ni cobrar.

Tarjetas de gráficos

typesearch arma sus propias tarjetas de gráficos con POST /v1/charts, y con la herramienta create_chart del servidor MCP. Pides con tus palabras y recibes el gráfico, las cifras clave, un título que cuenta el hallazgo, un embed, una PNG y un SVG. Salen de las noticias (cobertura, cuota de voz, tono, medios, cronologías y las cifras que publican las notas, encontradas tal cual) o de tus propios datos, con la fuente de cada valor. Para reemplazar las tarjetas de Tako, llámalo junto a la búsqueda compatible:

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

La respuesta trae el embed_url, el image_url y el svg_url de la tarjeta, los datos dibujados en chart y las sources. Desde una consulta cuesta su búsqueda más $0,50 cada 1.000 gráficos, desde $1,50 cada 1.000 en total; como referencia, la Search de Tako, que devuelve tarjetas de gráficos, cuesta $7 cada 1.000.

Parámetros

Tako	En typesearch
`effort`	`instant` → `ultra` · `fast` → `fast` · `deep` → `deep`.
`sources.web.count`	Igual, de 1 a 20.
`sources.web.category`	`sports` → la sección de deportes · `finance` → economía · `news` → todo.
`include_domains`, `exclude_domains`	Igual.
`published_after`, `published_before`	Igual.
`highlights`	Fragmentos textuales de las notas leídas.
`include_contents`	`content` vuelve `null` (`limited:content`): sólo fragmentos.
`output_settings.flat_results`, `force_refresh`	Igual.

Los errores mantienen el formato de Tako: { error_message, error_type }.

Lo nuestro

Agrega un campo typesearch al cuerpo JSON para pedir tono, lo esencial, un modo o un tope de costo; vuelve en un campo typesearch de la respuesta. Para todo lo demás, la API nativa y nuestros SDKs lo exponen completo.

Lo que se queda en Tako

Las tarjetas de Tako se apoyan en datasets licenciados (mercados, economía, estadísticas deportivas) que nosotros no tenemos: nuestros gráficos salen de lo que publican las noticias y de tus datos. Si tu producto depende de esos datasets, o de respuestas que redacta la propia API, deja eso en Tako y trae aquí tu búsqueda web.