API de comprobación de perfil completo de MAX: género, última vez y avatar

Para los números de teléfono registrados en MAX Messenger (oneme.ru), obtenga su información completa de perfil: ID de cuenta, nombre visible, género, hora de última conexión y enlace del avatar.

Ejemplo de carga del archivo de comprobación:

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="max_full"'

Ejemplo de consulta del estado de la tarea:

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

Respuesta cuando la carga se realiza correctamente

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

Respuesta durante el procesamiento

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:01:30.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Respuesta al finalizar (exported)

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:03:00.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip"
}

URL de solicitud para cargar el archivo

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

Parámetros de la solicitud de carga

Parámetro	Descripción
file	file, un número de teléfono por línea (formato E.164, por ejemplo, +79991234567)
task_type	string, establézcalo en max_full

Tamaño mínimo de lote: 1000 números por tarea.

URL de solicitud para consultar el estado de la tarea

POST https://api.numberchecker.ai/v1/gettasks

Parámetros de la solicitud de estado

Parámetro	Descripción
task_id	string, ID de tarea devuelto al crearla

Campos del resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+79991234567
max	Indica si el número está registrado en MAX Messenger	yes, no
id	ID interno de usuario de la cuenta MAX (solo si max=yes)	75240310
name	Nombre visible de la cuenta (nombre/apellido; puede estar incompleto)	Екатерина Сагайдак
gender	Género de la cuenta (si lo ha indicado el usuario)	male, female
last_seen	Estado de actividad o descripción de última conexión	last seen recently, last seen 2 days ago
avatar	URL de la imagen del avatar (vacía si no hay avatar)	https://i.oneme.ru/i?r=…

Las filas con max=no tienen vacías todas las columnas de perfil.

Formato de respuesta

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
task_id	Identificador único de la tarea
user_id	ID de usuario
status	pending · processing · exported
total	Total de números de teléfono procesados
success	Números identificados correctamente
failure	Números cuyo procesamiento falló
result_url	URL de descarga cuando status es exported

Códigos de estado

Estado	Descripción
200	charge, solicitud correcta
400	free, solicitud no válida
500	free, error del servidor