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 uma foto de rosto re-hospedada, recortada da publicação mais recente que contém um rosto, 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.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"'

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.250000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Consultar o status

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

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.250000",
    "currency": "USD"
  }
}

Campos do resultado

Campo	Descrição	Exemplo
username	Usuário ou URL enviados, exatamente como submetidos.	cristiano
activated	Se a conta existe (no = usuário inexistente).	yes
avatar	URL pública da foto de rosto recortada da publicação mais recente com rosto, re-hospedada em ins.waavatar.xyz (não expira); vazia se não houver rosto, a conta for privada ou sem publicações.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
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
private	Se a conta é privada (yes/no).	no
verified	Se a conta tem selo de verificação (yes/no).	yes
face_status	Resultado da extração: ok (recorte maior que 400 px), ok_small (rosto pequeno mantido), no_face, no_640_face (sem imagem de pelo menos 640 px), private, empty (sem publicações), posts_missed.	ok

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.
• As fotos são recortadas de publicações públicas na resolução servida pelo Instagram a visitantes sem login (640 px), por isso a maioria fica abaixo de 400 px e é marcada como ok_small.
• Os campos acima se baseiam na amostra atual e podem mudar se o esquema de exportação mudar.