API profunda del verificador masivo de números de WhatsApp

Compruebe los datos demográficos y atributos de perfil de números globales en WhatsApp, incluidos el género, la edad y el análisis de la foto de perfil.

URL de la API

POST https://api.checknumber.ai/v1/tasks

Características principales

La API profunda del verificador masivo de números de WhatsApp ofrece potentes capacidades analíticas:

Análisis demográfico

La API proporciona información demográfica detallada a partir de las fotos de perfil, que incluye:

Detección de género
Estimación de edad
Análisis del color del pelo
Detección del estilo de apariencia

Atributos del perfil

Información completa del perfil, que incluye:

Verificación del estado de la cuenta de WhatsApp
Obtención de la URL de la foto de perfil
Clasificación del tipo de foto de perfil
Estado de verificación de la cuenta

Procesamiento en masa

Procese varios números a la vez mediante la subida de un archivo, lo que resulta eficiente para análisis a gran escala.

Pasos de uso

Subida de archivo

Suba un archivo de texto con números de teléfono en formato E.164:

Ejemplo de petición

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file"' \
--form 'task_type="ws_avatar"'

Parámetros de la petición

Parámetro	Tipo	Descripción
`file`	`file`	Archivo con los números a verificar, un número por línea
`task_type`	`string`	`ws_avatar` — atributos basados en el avatar

Comprobación de estado

Consulte el estado de procesamiento de su tarea:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Ejemplos de respuesta

Respuesta de creación de tarea

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Respuesta de estado en procesamiento

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Respuesta de tarea completada

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Campos del resultado de verificación de números de WhatsApp

Campo	Descripción	Ejemplo
`Number`	Número de teléfono en formato E.164	+41798284651
`age`	Rango de edad estimado a partir de la foto de perfil	25
`avatar`	URL de la foto de perfil de WhatsApp	https://checknumber.ai/favicon.png
`category`	Clasificación del tipo de foto de perfil	retrato individual, avatar de mascota, objeto, etc.
`gender`	Género detectado a partir de la foto de perfil	male, female
`hair_color`	Color del pelo detectado a partir de la foto de perfil	black, brown, blonde, etc.
`whatsapp`	Si el número tiene una cuenta de WhatsApp activa	yes, no

Formato de respuesta de la API

Campo	Descripción
`created_at`	Marca de tiempo de creación de la tarea
`updated_at`	Marca de tiempo de la última actualización de estado de la tarea
`task_id`	Identificador único de la tarea
`status`	Estado de la tarea: pending/processing/completed/exported
`total`	Total de números de teléfono procesados
`success`	Números identificados correctamente
`failure`	Números cuyo procesamiento falló
`result_url`	(Opcional) URL de descarga de los resultados cuando el estado es exported

Códigos de estado

Estado	Descripción
`200`	`charge`, petición correcta, tarea creada o estado obtenido
`400`	`free`, petición incorrecta, parámetros o formato de archivo no válidos
`500`	`free`, error interno del servidor, inténtelo de nuevo más tarde

Notas de integración

Cada línea del archivo de entrada debe contener un número de teléfono en formato E.164.
Supervise el estado de la tarea con el task_id proporcionado.
Descargue los resultados desde result_url cuando el estado sea “exported”.
Gestione adecuadamente los distintos códigos de estado en su aplicación.

Preguntas frecuentes

1. ¿Qué capacidad de procesamiento tiene la API?

La API puede procesar grandes lotes de números de forma eficiente, con actualizaciones en tiempo real sobre el progreso del procesamiento.

2. ¿En qué formato debe estar el archivo de entrada?

El archivo de entrada debe ser un archivo de texto con un número de teléfono por línea en formato E.164 (p. ej., +41798284651).

3. ¿Qué precisión tiene el análisis demográfico?

El análisis demográfico se basa en un procesamiento avanzado con IA de las fotos de perfil y proporciona estimaciones de edad, género y otros atributos cuando están disponibles.

4. ¿Cuáles son los códigos de estado de respuesta de la API?

La API utiliza códigos de estado HTTP estándar para indicar éxito o fallo:

200: petición correcta (de pago)
400: parámetros o formato de archivo no válidos (gratis)
500: error interno del servidor (gratis)

5. ¿Cuál es el precio de la API?

El precio es de $3.8 USD por 10.000 números. La información de respuesta de esta API incluye:

Verificación del estado de la cuenta de WhatsApp
Detección de género
Estimación de edad
Análisis del tipo de foto de perfil
Detección del estilo de apariencia
Análisis del color del pelo

Para más información sobre precios y procesamiento de mayores volúmenes, contáctenos.