Encontrar similares
Notas del índice sobre la misma noticia que una URL.
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
urluriobligatorioLa nota de referencia: una URL completa. Los resultados son otras notas sobre la misma noticia.
sourcesenum<string>[]Sólo estas fuentes del índice. Usa los ids de
GET /v1/sources.include_domainsstring[]Sólo estos dominios o rutas, hasta 20. Un dominio incluye sus subdominios; una ruta como
infobae.com/economia, todo lo que cuelga de ella.exclude_domainsstring[]Nunca estos dominios o rutas, hasta 20. Las mismas reglas que
include_domains.sectionsstring[]Sólo estas secciones: la que declara la fuente, o el primer tramo de la ruta (
economia).daysinteger | nullLos últimos N días, de 1 a 365.
nullbusca en todo el índice. Por defecto 7, salvo que se indiquepublished_afteropublished_before.published_afterdate | date-timePublicadas 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-timePublicadas hasta este momento, inclusive. El mismo formato que
published_after.modeenum<string>Por defecto:"normal"ultrajuzga sólo titulares y es lo más barato ·fastjuzga titulares y bajadas ·normalademás lee los mejores resultados para confirmarlos ·deepjuzga todo el índice y lee más.max_resultsintegerPor defecto:10Cuántos resultados devolver, de 1 a 50.
highlightsbooleanDevuelve fragmentos textuales (hasta 280 caracteres) de las notas leídas. Por defecto
trueendeepyfalseen los demás.dedupebooleanPor defecto:falseAgrupa la misma noticia contada por varios medios en un solo resultado, con los demás en
duplicates.tonebooleanPor defecto:falseClasifica cada resultado como positivo, neutral o negativo respecto de la consulta, y lo resume por fuente.
essentialbooleanDevuelve hasta tres fragmentos textuales de fuentes distintas que resumen la noticia. Por defecto
trueendeep.questionsmapa<string, …>Salida estructurada: hasta 8 preguntas tipadas (
boolean,choiceoscore) respondidas sobre cada resultado, con el nombre que elijas.max_tokensinteger | nullUn tope de tokens del modelo para el pedido, mínimo 2000. Si se alcanza, recibes todo lo juzgado hasta ahí con
incomplete: true.freshbooleanPor defecto:falseIgnora la caché de resultados. Si no, un pedido idéntico dentro de los 10 minutos sale de la caché sin costo.
Respuesta
Los mismos campos que POST /v1/search, con object: "similar"
y reference completo.