Pular para o conteúdo

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.checknumber.ai/v1/tasks

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

Consultar o status

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

Terminal window
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.100000",
"currency": "USD"
}
}

Campos do resultado

CampoDescriçãoExemplo
usernameUsuário ou URL enviados, exatamente como submetidos.cristiano
activatedSe 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
avatarURL 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
visibilitySe a conta do Instagram é privada: private ou public; vazio para contas inexistentes.public
ig_usernameNome de usuário do Instagram resolvido (também preenchido quando o valor enviado era um ID numérico); vazio para contas inexistentes.villavicenciopaul
full_nameNome exibido no perfil.Cristiano Ronaldo
postsNúmero de publicações.4138
followersNúmero de seguidores.679725371
followingNúmero de perfis seguidos.636
verifiedSe 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

CampoDescrição
created_atData de criação da tarefa.
updated_atData da última atualização de status.
task_idIdentificador único da tarefa.
statuspending, processing, exported ou failed.
totalTotal de valores processados.
successValores processados com sucesso.
failureValores com falha.
result_urlURL de download quando a tarefa é exportada.
actual_amountValor final liquidado, quando disponível.
estimated_amountValor estimado retornado na criação da tarefa.

Códigos de status

StatusDescrição
200Solicitação bem-sucedida.
202Tarefa criada e cobrança estimada aplicada.
400Arquivo inválido, tipo de tarefa não suportado ou poucas entradas válidas.
401Chave de API ausente ou inválida.
402Saldo insuficiente.
403Produto indisponível para sua conta (error: product_not_available): descontinuado, restrito à lista de permissões ou não oferecido pela API. Produtos não oferecidos pela API podem ser enviados pelo painel; nos demais casos, entre em contato com o suporte.
404Tarefa não encontrada.
413Arquivo enviado muito grande.
500Erro interno; tente novamente mais tarde.
503Produto 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.