WA Lookup

Contrato de la API

Dos pasos: enviar el archivo y consultar la tarea

Leer la documentación completa de la API Abrir claves API

Al enviar se devuelve de inmediato un ID de tarea; consulte la tarea con ese ID y, cuando se complete correctamente, la respuesta incluirá el enlace de descarga del archivo de resultados. Cada solicitud se muestra con su propia respuesta.

1. Enviar el archivo

El ID de tarea se devuelve de inmediato con preparing en true mientras el archivo se prepara en segundo plano: se eliminan las líneas no válidas, los duplicados y, en las tareas de números, los números sin código de país o de otro país, que no se cobran. El saldo se reserva para las líneas enviadas y se liquida al completarse; la diferencia se reembolsa.

Solicitud cURLPOST /api/v1/bulk-tasks
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_active_batch \
  -F country=US \
  -F file=@numbers.txt
Respuesta: tarea creada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_active_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

2. Consultar la tarea

Sondee por ID de tarea. Cuando finaliza la preparación, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, donde total es lo que se verifica y se cobra. Una respuesta correcta incluye los recuentos de éxitos y fallos y el enlace de descarga del archivo de resultados; una tarea rechazada durante la preparación queda en failed con reason_detail y se reembolsa íntegramente.

Solicitud cURLGET /api/v1/bulk-tasks/{id}
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Respuesta: tarea finalizada200 OK
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_active_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Cómo se ejecuta

Qué ocurre con una tarea masiva

El modo masivo no es una versión ampliada del tiempo real: se envía una vez, se ejecuta en segundo plano y se recoge más tarde. No necesita mantener la página abierta; el estado de la tarea y los resultados permanecen en su panel.

  1. 01Suba el archivo

    Un archivo .txt o .csv con un número por línea. Se transmite directamente; no se escribe nada en disco.

  2. 02Comprobación previa y reserva

    Los problemas evidentes (un archivo vacío, un formato incorrecto, muy pocas líneas) se rechazan al subirlo. A continuación se reserva el saldo y el archivo se prepara en segundo plano: se eliminan las líneas no válidas, los duplicados y los números sin código de país o de otro país, y se comprueba la regla de un solo país. Un archivo que no supera esa fase termina como tarea fallida y se reembolsa íntegramente; en caso contrario, solo se verifican las líneas restantes y la tarea se liquida al completarse.

  3. 03Ejecución en segundo plano

    La tarea se ejecuta por sí sola: puede cerrar la página si lo desea. Un fallo se notifica de inmediato y se reembolsa íntegramente.

  4. 04Descargue el resultado

    Recoja el archivo en la página de verificación masiva. Solo paga por los números que realmente devolvieron un resultado; la diferencia se reembolsa.

Cuándo encaja el modo masivo

Cuándo merece la pena el modo masivo y cuándo es más rápido el tiempo real

Verificación en tiempo realVerificación masiva
Cuántos números1 número por verificación individual; varios por solicitud múltiple: los límites exactos figuran en la documentación de la APIUna lista grande completa en una sola tarea: el intervalo de tamaño actual figura en la página de precios
Obtención de resultadosDe inmediato: el endpoint individual y el múltiple responden en la misma respuesta; el panel los devuelve uno a unoDescargue un archivo de resultados cuando termine la tarea
País / regiónSin restricciones: combine libremente en una sola solicitudElija un país/región al enviar; la lista debe ser esencialmente de ese país, y demasiados números de otros lugares hacen fallar la tarea con reembolso íntegro
Formato del resultadoJSON, campos por númeroArchivo de resultados (un CSV con la tabla completa)
Uso habitualValidación de formularios, consultas de agentes, filtrado previo al envíoDepuración de listas, filtrado previo a campañas, limpieza de datos almacenados

Verificación en tiempo real · Ver precios

Preguntas frecuentes del producto

Acerca de Verificación de actividad

¿Cuándo debo usar el modo masivo en lugar de una verificación en tiempo real?

Use el modo masivo para una lista grande completa. Para unos pocos números, la verificación en tiempo real responde en la misma solicitud, sin ninguna tarea que programar.

¿Qué ocurre con los números no válidos del archivo?

La comprobación previa descarta las líneas mal formadas, por lo que nunca entran en el recuento facturable. De los números restantes, tampoco se cobran los que el servicio de origen no pueda resolver. Solo paga por los números que realmente devuelven un resultado.

¿Cuánto tarda una tarea?

Depende de la cantidad de números y del producto. Puede cerrar la página después de enviarla; la tarea se ejecuta en segundo plano y el resultado le espera en la página de verificación masiva.

¿Se me reembolsa si falla?

Sí. Una tarea fallida se reembolsa íntegramente. Si la tarea se completa correctamente pero algunos números no devuelven nada, esa parte se reembolsa automáticamente. La diferencia entre el importe reservado y lo realmente cobrado siempre se devuelve.

Productos relacionados

Otros productos masivos

Verificación masiva de registro en WhatsAppSuba un archivo completo de números, averigüe cuáles están registrados en WhatsApp y descargue el archivo de resultados cuando termine.Verificación masiva de avatar de WhatsAppVerifique en toda una lista el registro en WhatsApp y el avatar: si cada número registrado tiene un avatar configurado, además de la URL del avatar.Verificación masiva Business de WhatsAppVerifique en toda una lista las cuentas de WhatsApp Business: si cada número está en WhatsApp y si esa cuenta es una cuenta de WhatsApp Business.