Enrichments

Tone, dedupe and essentials are options you turn on; diffusion comes with every search that finds something. They work with search, similar and site_search, and can be combined.

const res = await ts.search('el dólar', {
  mode: 'deep',
  tone: true,
  dedupe: true,
  essential: true,
});

Tone

tone: true classifies each result as positive, neutral or negative relative to your query — not the general mood of the article — and adds a summary by source.

{ "label": "negative", "probabilities": { "positive": 0.04, "neutral": 0.21, "negative": 0.75 }, "basis": "article" }

{
  "articles": 42,
  "overall": { "positive": 6, "neutral": 25, "negative": 11 },
  "by_source": [{ "source": "Infobae", "positive": 2, "neutral": 9, "negative": 4 }]
}

The scale is the same for news, blogs or social posts, so summaries are comparable across sources. basis says whether the article text or only its headline was judged.

Dedupe

dedupe: true collapses the same story told by several outlets into one result and lists the others in duplicates. It is off by default because sometimes the repetition is the signal.

Essentials

essential: true returns up to three verbatim excerpts from different sources that capture the story — chosen by the model from the highlights, first paragraphs and standfirsts of the top results. It is not a generated summary: every sentence was published by someone, with a link to it.

{
  "excerpts": [
    { "text": "El dólar mayorista terminó la jornada sin variaciones…", "url": "https://www.infobae.com/…", "source": "Infobae", "title": "…" }
  ]
}

On by default in deep.

Diffusion

Every response to a search with results includes diffusion: articles per day, per source, and who published first. It is computed from the index, so it costs nothing.

{
  "by_day": [{ "day": "2026-09-21", "count": 18 }],
  "by_source": [{ "source": "La Nación", "count": 5, "first_published_at": "2026-09-21T11:02:00.000Z" }],
  "first": { "source": "La Nación", "url": "https://www.lanacion.com.ar/…", "title": "…", "published_at": "2026-09-21T11:02:00.000Z" },
  "undated": 0
}