API Perfil de ID/usuario de Instagram: perfiles masivos

Comprueba cuentas de Instagram por nombre de usuario (ID) o URL del perfil y devuelve la imagen completa de la publicación más reciente que contiene un rostro, realojada sin recortar, 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.numberchecker.ai/v1/tasks

curl --location 'https://api.numberchecker.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.100000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Consultar el estado

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

curl --location 'https://api.numberchecker.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.100000",
    "currency": "USD"
  }
}

Campos del resultado

Campo	Descripción	Ejemplo
username	Usuario o URL enviados, tal cual.	cristiano
activated	Si se obtuvo una imagen de avatar para este ID (yes/no). Las cuentas existentes sin imagen utilizable (privadas, sin publicaciones, sin rostro, imagen demasiado pequeña) y los IDs inexistentes son no. Solo se facturan las filas yes.	yes
avatar	URL pública de la publicación más reciente que contiene un rostro, realojada sin recortar en ins.waavatar.xyz (no caduca). Solo se entregan imágenes mayores de 500 px por lado; no se usan fotos de perfil. Vacía si no existe tal imagen (cuenta privada, sin publicaciones, sin rostro).	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Si la cuenta de Instagram es privada: private o public; vacío si la cuenta no existe.	public
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
verified	Si la cuenta tiene insignia de verificación (yes/no).	yes

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.
• La imagen entregada es la publicación completa (sin recorte) a la resolución que Instagram sirve sin sesión (640 px en el lado largo); solo se entrega si la región facial detectada supera 250 px.
• Los campos se basan en la muestra actual y pueden cambiar si cambia el esquema de exportación.