Consultar un trabajo

El estado y, cuando terminó, el resultado de una búsqueda en un sitio en vivo.

GEThttps://api.typesearch.ai/v1/jobs/{id}

Devuelve un trabajo creado con POST /v1/search/site. Consúltalo cada dos o tres segundos hasta que status sea succeeded o failed, o deja que el SDK lo haga con jobs.wait().

Los trabajos duran un día y sólo los ve la key que los creó; después de eso, o con otra key, devuelve 404 job_not_found.

Ruta

Parámetro	Tipo
`id`	string	El id del trabajo, de la respuesta `202` o de su encabezado `Location`.

Respuesta

Cuando el trabajo terminó bien, result es una respuesta de búsqueda con los mismos campos que POST /v1/search.

idstring
El id del trabajo. Duran un día y sólo los ve la key que los creó.
object"job"
Siempre job.
statusenum<string>
queued, running, succeeded o failed.
created_atstring
Cuándo se creó.
finished_atstring | null
Cuándo terminó.
resultobject | null
Cuando es succeeded: la respuesta de la búsqueda, con la misma forma que POST /v1/search.
Los mismos campos que la respuesta de POST /v1/search.
errorobject | null
Cuando es failed: el detalle del problema.
Ver los campos
- typestring
  urn:typesearch:error:<code>.
- titlestring
  Un resumen breve del estado.
- statusinteger
  El estado HTTP.
  Rango: -9007199254740991–9007199254740991
- detailstring
  Qué salió mal, para personas.
- codestring
  Un código de error estable, para programas.
- request_idstring
  Inclúyelo cuando escribas a soporte.
- errorsobject[]
  Errores de validación por campo, cuando el pedido no es válido.
  Ver los campos
  - pathstring
    El campo, por ejemplo query.
  - messagestring
    Qué tiene de malo.

const job = await ts.jobs.get('job_Qm3sV9aLp2Rt');

// o consúltalo hasta que termine
const res = await ts.jobs.wait('job_Qm3sV9aLp2Rt');

200 OK

{
  "id": "job_Qm3sV9aLp2Rt",
  "object": "job",
  "status": "succeeded",
  "created_at": "2026-09-22T14:03:11.000Z",
  "finished_at": "2026-09-22T14:03:39.000Z",
  "result": {
    "id": "job_Qm3sV9aLp2Rt",
    "object": "site_search",
    "mode": "normal",
    "site": "lanacion.com.ar",
    "found": true,
    "total": 6,
    "results": [
      {
        "url": "https://www.lanacion.com.ar/economia/…",
        "title": "Dólar hoy: a cuánto cotiza este lunes",
        "score": 0.97,
        "found_in": "section"
      }
    ]
  },
  "error": null
}