API Perfil de ID/usuario de Instagram: perfiles masivos

Comprueba cuentas de Instagram por nombre de usuario (ID) o URL del perfil y devuelve una foto de rostro realojada, recortada de la publicación más reciente que contiene un rostro, el nombre completo, el número de publicaciones, los seguidores y seguidos, y si la cuenta es privada o verificada. Las cuentas inexistentes se devuelven como no activadas; las privadas se devuelven como activadas con sus datos pero sin foto. La tarea usa el flujo asíncrono estándar por lotes.

Formato de entrada

Sube un archivo de texto con un nombre de usuario (ID) de Instagram por línea. Se aceptan username, @username y URLs completas instagram.com/<username>; la comparación no distingue mayúsculas.

También se aceptan IDs numéricos de Instagram (pk), que se resuelven al nombre de usuario.

cristiano
@zuck
https://www.instagram.com/natgeo/
1367088262

Crear una tarea

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

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

La API devuelve un ID de tarea. Guárdalo para consultar el estado.

Respuesta de carga

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "1.250000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Consultar el estado

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

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

Consulta hasta que status sea exported. No trates pending ni processing como resultado final.

Respuesta en proceso

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Respuesta exportada

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "1.250000",
    "currency": "USD"
  }
}

Campos del resultado

Campo	Descripción	Ejemplo
username	Usuario o URL enviados, tal cual.	cristiano
activated	Si la cuenta existe (no = no existe ese usuario).	yes
avatar	URL pública de la foto de rostro recortada de la última publicación con rostro, realojada en ins.waavatar.xyz (no caduca); vacía si no hay rostro, la cuenta es privada o no tiene publicaciones.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
ig_username	Nombre de usuario de Instagram resuelto (también cuando el valor enviado era un ID numérico); vacío si la cuenta no existe.	villavicenciopaul
full_name	Nombre mostrado en el perfil.	Cristiano Ronaldo
posts	Número de publicaciones.	4138
followers	Número de seguidores.	679725371
following	Número de seguidos.	636
private	Si la cuenta es privada (yes/no).	no
verified	Si la cuenta tiene insignia de verificación (yes/no).	yes
face_status	Resultado de la extracción: ok (recorte mayor de 400 px), ok_small (rostro pequeño conservado), no_face, no_640_face (sin imagen de al menos 640 px), private, empty (sin publicaciones), posts_missed.	ok

Manejo del archivo

Descarga el archivo desde result_url solo cuando la tarea esté exportada. Conserva los nombres de columna al procesarlo.

Campos de respuesta

Campo	Descripción
created_at	Fecha de creación de la tarea.
updated_at	Fecha de la última actualización.
task_id	Identificador único de la tarea.
status	pending, processing, exported o failed.
total	Total de valores procesados.
success	Valores procesados correctamente.
failure	Valores con error.
result_url	URL de descarga cuando la tarea está exportada.
actual_amount	Importe final liquidado, si está disponible.
estimated_amount	Importe estimado devuelto al crear la tarea.

Códigos de estado

Estado	Descripción
200	Solicitud correcta.
202	Tarea creada y cargo estimado aplicado.
400	Archivo no válido, tipo de tarea no admitido o muy pocas entradas válidas.
401	Clave de API ausente o inválida.
402	Saldo insuficiente.
403	Producto no disponible para tu cuenta (retirado o solo lista blanca); contacta con soporte.
404	Tarea no encontrada.
413	El archivo subido es demasiado grande.
500	Error interno; reintenta más tarde.
503	Producto temporalmente no disponible (en mantenimiento); no se cobra, reintenta más tarde.

Notas operativas

• La tarea es asíncrona; usa el ID para consultar el estado.
• Revisa los límites de entrada del producto antes de subir.
• Las filas con error se reflejan en el resultado exportado y en los contadores.
• Las fotos se recortan de publicaciones públicas a la resolución que Instagram sirve sin sesión (640 px), por lo que la mayoría queda por debajo de 400 px y se marca como ok_small.
• Los campos se basan en la muestra actual y pueden cambiar si cambia el esquema de exportación.