Encontrar similares

POSThttps://api.typesearch.ai/v1/similar

Lee la nota de url y busca en el índice otras sobre la misma noticia. La respuesta tiene la misma forma que POST /v1/search, con la nota de referencia en reference.

Cuerpo

urluriobligatorio
La nota de referencia: una URL completa. Los resultados son otras notas sobre la misma noticia.
sourcesstring[]
Sólo estas fuentes, por dominio (como diarioejemplo.example), hasta 100. Un dominio que no está en el índice vuelve como aviso domain_not_indexed.
Elementos: hasta 100
include_domainsstring[]
Sólo estos dominios o rutas, hasta 20. Un dominio incluye sus subdominios; una ruta como diarioejemplo.example/economia, todo lo que cuelga de ella.
Elementos: hasta 20
exclude_domainsstring[]
Nunca estos dominios o rutas, hasta 20. Las mismas reglas que include_domains.
Elementos: hasta 20
countriesstring[]
Sólo fuentes con sede en estos países: códigos ISO 3166-1 alfa-2, como AR o US.
Elementos: hasta 50
languagesstring[]
Sólo fuentes que publican en estos idiomas: códigos ISO 639-1, como es o en. Una etiqueta como pt-BR cuenta como pt.
Elementos: hasta 20
sectionsstring[]
Sólo estas secciones: la que declara la fuente, o el primer tramo de la ruta (economia).
Elementos: hasta 20
daysinteger | null
Los últimos N días, de 1 a 365. null busca en todo el índice. Por defecto 7, salvo que se indique published_after o published_before.
Rango: 1–365
published_afterdate | date-time
Publicadas desde este momento. Una fecha sola (2026-09-20) cubre el día entero en UTC−3; una fecha y hora necesita la zona.
published_beforedate | date-time
Publicadas hasta este momento, inclusive. El mismo formato que published_after.
modeenum<string>Por defecto: "normal"
ultra juzga sólo titulares y es el más barato · fast juzga titulares y bajadas · normal además lee los mejores resultados para confirmarlos · deep juzga todo el índice y lee más.
max_resultsintegerPor defecto: 10
Cuántos resultados devolver, de 1 a 50.
Rango: 1–50
highlightsboolean
Devuelve un fragmento textual breve de las notas leídas: como mucho uno por nota (dos en deep), de hasta 25 palabras y nunca del primer párrafo. Por defecto true en deep y false en los demás.
dedupebooleanPor defecto: false
Agrupa la misma noticia contada por varios medios en un solo resultado, con los demás en duplicates.
tonebooleanPor defecto: false
Clasifica cada resultado como positivo, neutral o negativo respecto de la consulta, y lo resume por fuente.
essentialboolean
Devuelve hasta tres fragmentos textuales de fuentes distintas que resumen la noticia, con los mismos límites que highlights. Por defecto true en deep.
questionsmapa<string, …>
Salida estructurada: hasta 8 preguntas tipadas (boolean, choice o score) respondidas sobre cada resultado, con el nombre que elijas.
max_tokensinteger | null
Un tope de tokens del modelo para el pedido, mínimo 2000. Si se alcanza, recibes todo lo juzgado hasta ahí con incomplete: true.
Rango: 2000–9007199254740991
freshbooleanPor defecto: false
Ignora la caché de resultados. Si no, un pedido idéntico dentro de los 10 minutos sale de la caché sin costo.
temporalenum<string>Por defecto: "auto"
auto: a date in the query («today», «yesterday», «tomorrow», «on September 22», «this week») is taken out of the topic, sets the publication window (unless published_after/before are given; days only bounds it) and puts the results from that day first · off: the query is taken literally.
Uno de: auto · off
timezonestring
IANA time zone that decides what day «today» is. Defaults to Argentina (America/Argentina/Buenos_Aires).

Respuesta

Los mismos campos que POST /v1/search, con object: "similar" y reference completo.

const res = await ts.similar('https://diarioejemplo.example/economia/…', {
  mode: 'fast',
  exclude_domains: ['diarioejemplo.example'],
});

200 OK

{
  "id": "req_Wn7cK2pXq9Ld",
  "object": "similar",
  "mode": "fast",
  "reference": {
    "url": "https://diarioejemplo.example/economia/…",
    "title": "Inflación: qué esperan los analistas para los próximos meses"
  },
  "found": true,
  "total": 9,
  "results": [
    {
      "url": "https://plaza.example/economia/…",
      "title": "Relevamiento de expectativas: las proyecciones de precios",
      "source": "Plaza Financiera",
      "score": 0.91,
      "found_in": "index"
    }
  ]
}