API Perfil de ID/usuário do Instagram: perfis em massa

Verifique contas do Instagram por nome de usuário (ID) ou URL do perfil e obtenha a imagem completa da publicação mais recente que contém um rosto, re-hospedada sem recorte, nome completo, número de publicações, seguidores e seguindo, e se a conta é privada ou verificada. Contas inexistentes retornam como não ativadas; contas privadas retornam como ativadas com os dados do perfil, mas sem foto. A tarefa usa o fluxo assíncrono padrão em lote.

Formato de entrada

Envie um arquivo de texto com um nome de usuário (ID) do Instagram por linha. username, @username e URLs completas instagram.com/<username> são aceitos; a comparação não diferencia maiúsculas.

IDs numéricos do Instagram (pk) também são aceitos e resolvidos para o nome de usuário.

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

Criar uma tarefa

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"'

A API retorna um ID de tarefa. Guarde-o para consultar o status.

Resposta do envio

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

Consultar o status

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"'

Consulte até status ser exported. Não trate pending ou processing como resultado final.

Resposta em processamento

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

Resposta 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 do resultado

Campo	Descrição	Exemplo
username	Usuário ou URL enviados, exatamente como submetidos.	cristiano
activated	Se uma imagem de avatar foi obtida para este ID (yes/no). Contas existentes sem imagem utilizável (privadas, sem publicações, sem rosto, imagem pequena demais) e IDs inexistentes são no. Apenas linhas yes são cobradas.	yes
avatar	URL pública da publicação mais recente que contém um rosto, re-hospedada sem recorte em ins.waavatar.xyz (não expira). Só são entregues imagens com mais de 500 px de lado; fotos de perfil não são usadas. Vazia quando não há tal imagem (conta privada, sem publicações, sem rosto).	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Se a conta do Instagram é privada: private ou public; vazio para contas inexistentes.	public
ig_username	Nome de usuário do Instagram resolvido (também preenchido quando o valor enviado era um ID numérico); vazio para contas inexistentes.	villavicenciopaul
full_name	Nome exibido no perfil.	Cristiano Ronaldo
posts	Número de publicações.	4138
followers	Número de seguidores.	679725371
following	Número de perfis seguidos.	636
verified	Se a conta tem selo de verificação (yes/no).	yes

Tratamento do arquivo

Baixe o arquivo de result_url apenas após a exportação. Preserve os nomes das colunas ao processá-lo.

Campos da resposta

Campo	Descrição
created_at	Data de criação da tarefa.
updated_at	Data da última atualização de status.
task_id	Identificador único da tarefa.
status	pending, processing, exported ou failed.
total	Total de valores processados.
success	Valores processados com sucesso.
failure	Valores com falha.
result_url	URL de download quando a tarefa é exportada.
actual_amount	Valor final liquidado, quando disponível.
estimated_amount	Valor estimado retornado na criação da tarefa.

Códigos de status

Status	Descrição
200	Solicitação bem-sucedida.
202	Tarefa criada e cobrança estimada aplicada.
400	Arquivo inválido, tipo de tarefa não suportado ou poucas entradas válidas.
401	Chave de API ausente ou inválida.
402	Saldo insuficiente.
403	Produto indisponível para sua conta (descontinuado ou apenas lista branca); contate o suporte.
404	Tarefa não encontrada.
413	Arquivo enviado muito grande.
500	Erro interno; tente novamente mais tarde.
503	Produto temporariamente indisponível (em manutenção); nada é cobrado, tente mais tarde.

Notas operacionais

• A tarefa é assíncrona; use o ID para consultar o status.
• Verifique os limites de entrada do produto antes de enviar.
• Linhas com falha aparecem no resultado exportado e nos contadores.
• A imagem entregue é a publicação inteira (sem recorte) na resolução servida pelo Instagram sem login (640 px no lado maior); só é entregue quando a região facial detectada excede 250 px.
• Os campos acima se baseiam na amostra atual e podem mudar se o esquema de exportação mudar.