Buscar en un sitio en vivo

POSThttps://api.typesearch.ai/v1/search/site

Lee el sitio en vivo: primero la portada y, si no alcanza, las secciones con más chances de cubrir el tema y el buscador del propio sitio, en paralelo. Puede tardar hasta un minuto, así que responde 202 Accepted con un trabajo y un encabezado Location.

Con stream: true responde con Server-Sent Events.

Cuerpo

sitestringobligatorio
El sitio en vivo donde buscar: un dominio como diarioejemplo.example, o una URL.
querystringobligatorio
Qué buscar en el sitio. De 2 a 200 caracteres.
sectionsstring[]
Sólo estas secciones: la que declara la fuente, o el primer tramo de la ruta (economia).
Elementos: hasta 20
exclude_domainsstring[]
Nunca estos dominios o rutas, hasta 20. Las mismas reglas que include_domains.
Elementos: hasta 20
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).
streambooleanPor defecto: false
Envía Server-Sent Events en vez de crear un trabajo.

Respuesta

202 Accepted con un trabajo. Mira GET /v1/jobs/{id} para sus campos.

import Typesearch from 'typesearch-js';

const ts = new Typesearch();

// Crea el trabajo y espera el resultado
const res = await ts.siteSearchAndWait('diarioejemplo.example', 'el dólar', {
  mode: 'normal',
  max_results: 10,
});

202 Accepted

{
  "id": "job_Qm3sV9aLp2Rt",
  "object": "job",
  "status": "queued",
  "created_at": "2026-09-22T14:03:11.000Z",
  "finished_at": null,
  "result": null,
  "error": null
}