Enriquecimientos

El tono, el agrupado y lo esencial son opciones que activas; la difusión viene en toda búsqueda que encuentra algo. Funcionan con search, similar y site_search, y se pueden combinar.

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

Tono

tone: true clasifica cada resultado como positive, neutral o negative respecto de tu consulta —no el clima general de la nota— y agrega un resumen por fuente.

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

La escala es la misma para medios, blogs o redes, así que los resúmenes se pueden comparar entre fuentes. basis dice si se juzgó el texto de la nota o sólo su titular.

Agrupar la misma noticia

dedupe: true agrupa la misma noticia contada por varios medios en un solo resultado y lista los demás en duplicates. Está apagado por defecto porque a veces la repetición es el dato.

Lo esencial

essential: true devuelve hasta tres fragmentos textuales de fuentes distintas que resumen la noticia, elegidos por el modelo entre los fragmentos, los primeros párrafos y las bajadas de los mejores resultados. No es un resumen generado: cada oración la publicó alguien, con el enlace a la nota.

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

Activado por defecto en deep.

Difusión

Toda respuesta a una búsqueda con resultados incluye diffusion: notas por día, por fuente, y quién publicó primero. Sale del índice, así que no cuesta nada.

{
  "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
}