Inicio rápido

Consigue una API key

Crea una key en el panel: las cuentas nuevas reciben US$5 de crédito gratis para probar, sin tarjeta. Las keys empiezan con ts_live_ y se muestran una sola vez, así que guárdala como variable de entorno:

export TYPESEARCH_API_KEY="ts_live_…"

Los SDKs leen TYPESEARCH_API_KEY solos.

Instala el SDK

npm install typesearch-js

O sáltate el SDK y llama a la API HTTP directamente: es JSON simple.

Haz tu primera búsqueda

import Typesearch from 'typesearch-js';

const ts = new Typesearch();

const res = await ts.search('inflación en Argentina', { mode: 'fast', max_results: 5 });

for (const r of res.results) {
  console.log(r.score.toFixed(2), r.title, `(${r.source})`);
}

Lee la respuesta

Cada resultado trae un score: la probabilidad calibrada de que trate de tu consulta. Puedes poner el umbral directamente sobre él: 0.9 es relevante, y cualquier valor entre 0.35 y 0.65 significa que el modelo no se decide.

{
  "id": "req_8fKq2mZr1xYt",
  "object": "search",
  "mode": "fast",
  "found": true,
  "total": 23,
  "results": [
    {
      "url": "https://www.lanacion.com.ar/economia/…",
      "title": "Inflación: qué esperan los analistas para los próximos meses",
      "source": "La Nación",
      "published_at": "2026-09-21T12:40:00.000Z",
      "score": 0.95,
      "read": null,
      "highlights": []
    }
  ],
  "usage": { "tokens": 1840, "calls": 2, "cost_usd": 0.001, "duration_ms": 910 },
  "warnings": []
}

En el modo fast los resultados se juzgan por el titular y la bajada. Pasa a normal para que los mejores se lean y se confirmen: vuelven con read y con highlights textuales.