tverificas.
DocumentaciónIr al dashboard →
Endpoints

Estado de búsqueda

Consulta el estado y resultado de una búsqueda específica. Es el endpoint que se usa para hacer polling cuando lanzaste un POST con ?async=true.

GET/v1/searches/{id}

Ejemplo

curlbash
curl https://api.tverificas.com/v1/searches/9cf1dc24-193b-4c73-8672-1562daa53d7c \
  -H "Authorization: Bearer $TVERIFICAS_API_KEY"

Patrón de polling

Si lanzaste el POST con ?async=true, recibes 202 con la búsqueda en estado pending. Haz polling cada 1-2 segundos sobre este endpoint hasta que status sea completed, degraded o failed.

JavaScriptjavascript
async function pollSearch(id) {
  while (true) {
    const r = await fetch(`https://api.tverificas.com/v1/searches/${id}`, {
      headers: { Authorization: `Bearer ${process.env.TVERIFICAS_API_KEY}` },
    });
    const search = await r.json();
    if (["completed", "degraded", "failed"].includes(search.status)) {
      return search;
    }
    await new Promise((r) => setTimeout(r, 1500));
  }
}