API de Verificación Masiva de Números: Verificación en Cian

Verifica si los números de teléfono de tu archivo tienen cuentas en Cian.ru. Mismo flujo de tareas por lotes que otros verificadores de redes sociales / mensajería.

Ejemplo para subir el archivo de detección:

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

Ejemplo para consultar el estado de la tarea:

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

Respuesta cuando la carga del archivo fue exitosa

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2026-04-28T11:58:08.916446594Z"
}

Respuesta para el estado de procesamiento

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Respuesta cuando la tarea está completada (incluye la URL de descarga)

{
    "created_at": "2026-04-28T08:27:09.933Z",
    "updated_at": "2026-04-28T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL de solicitud para subir archivo

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

Parámetros de solicitud para subir archivo

Parámetro	Descripción
file	file, un número de teléfono por línea (formato E.164)
task_type	string, establecer en cian

URL de solicitud para consultar estado

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

Parámetros de solicitud para consultar estado

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

Campos del resultado

Campo	Descripción
Number	Número de teléfono en formato E.164
cian	Si el número está registrado en Cian.ru (estilo yes / no; etiquetas según la exportación)

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 del estado de la tarea
task_id	Identificador único de la tarea
user_id	ID de usuario
status	pending · processing · exported · failed (se reembolsa automáticamente)
total	Total de números de teléfono procesados
success	Números identificados con éxito
failure	Números que fallaron en el procesamiento
result_url	URL de descarga cuando status es exported
actual_amount	(Opcional) Importe realmente cobrado, disponible cuando la tarea se liquida
estimated_amount	(Respuesta de creación) Importe estimado de la tarea; el cobro final se liquida al completarse

Códigos de estado

Estado	Descripción
200	free, Solicitud correcta (p. ej., consulta de estado)
202	charge, Tarea creada correctamente; se deduce el importe estimado
400	free, Solicitud incorrecta: parámetros o formato de archivo no válidos, tipo de tarea no admitido o entradas válidas por debajo del lote mínimo
401	free, Clave API ausente o no válida
402	free, Saldo insuficiente
404	free, Tarea no encontrada
413	free, Archivo subido demasiado grande
500	free, Error interno del servidor; inténtelo más tarde