Quickstart

Get an API key

Create a key in the dashboard: new accounts get $5 of free credit to try it, no card needed. Keys start with ts_live_ and are shown once, so store yours as an environment variable:

export TYPESEARCH_API_KEY="ts_live_…"

The SDKs read TYPESEARCH_API_KEY automatically.

Install the SDK

npm install typesearch-js

Or skip the SDK and call the HTTP API directly — it is plain JSON.

Run your first search

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})`);
}

Read the response

Every result carries a score: the calibrated probability that it is about your query. Threshold on it directly — 0.9 means relevant, and anything between 0.35 and 0.65 means the model is undecided.

{
  "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": []
}

In fast mode results are judged from the headline and standfirst. Switch to normal to have the top results read and confirmed: they come back with read and verbatim highlights.