Esta tarefa é síncrona?

Não. Crie uma tarefa, consulte o status e baixe o resultado quando o status for `exported`.

Qual tipo de tarefa devo usar?

Use `facebook_profile` para este produto.

O que o arquivo de resultado contém?

Contém o valor enviado e os campos específicos do produto documentados na tabela Campos do resultado.

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

Verifique perfis e páginas (Pages) do Facebook por ID numérico do perfil, nome de usuário (vanity) ou URL do perfil e obtenha a foto do perfil (re-hospedada em uma URL permanente), o ID numérico, o usuário canônico, o nome exibido, a descrição curta e as contagens de seguidores e de “pessoas falando sobre isso”. O produto lê apenas a página pública do perfil como ela aparece sem login: nenhum login é usado e nenhum dado de amigos é coletado. Perfis que não existem, estão desativados ou não são visíveis para visitantes sem login retornam como não ativados. A tarefa usa o fluxo assíncrono padrão em lote.

Formato de entrada

Envie um arquivo de texto com um identificador do Facebook por linha. Formas aceitas:

ID numérico do perfil, por exemplo 4
Nome de usuário (vanity), por exemplo zuck ou @zuck; letras, dígitos e pontos, de 1 a 50 caracteres, sem diferenciar maiúsculas
URL do perfil, por exemplo facebook.com/zuck, facebook.com/profile.php?id=100003012457235 ou facebook.com/people/<Name>/<ID>

URLs do facebook.com que não são de perfil (grupos, páginas de administração, login e caminhos semelhantes) são rejeitadas como entradas inválidas.

4
zuck
@Meta
https://www.facebook.com/profile.php?id=100003012457235
https://www.facebook.com/people/Mark-Zuckerberg/4/

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="facebook_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.500000",
    "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.500000",
    "currency": "USD"
  }
}

Campos do resultado

O CSV de resultado tem as colunas abaixo, nesta ordem: username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about.

Campo	Descrição	Exemplo
`username`	Identificador enviado (ID, usuário ou URL do perfil), exatamente como submetido.	4
`activated`	Se uma página de perfil pública foi obtida (`yes`/`no`). `no` significa que o perfil não existe, está desativado ou não é visível sem login; o Facebook mostra a mesma página “este conteúdo não está disponível” nos três casos, então não é possível distingui-los.	yes
`avatar`	URL permanente da foto do perfil, re-hospedada por nós em `fb.waavatar.xyz`. Vazia quando `activated` é `no`.	https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg
`fb_id`	ID numérico do perfil do Facebook extraído da página.	4
`fb_username`	Nome de usuário canônico (vanity) mostrado pelo Facebook; vazio em perfis que só têm ID.	zuck
`name`	Nome exibido.	Mark Zuckerberg
`image`	URL assinada do CDN do próprio Facebook com a foto do perfil. Expira em poucos dias; use `avatar` para um link durável.	https://scontent.xx.fbcdn.net/v/…jpg?…&oe=…
`tagline`	Texto curto da bio extraído da descrição da página; pode estar vazio.	Bringing the world closer together.
`followers`	Número de seguidores. Para páginas (Pages) é o número de “curtidas”. Inteiro; vazio quando não exibido.	121439077
`talking_about`	Contagem de “pessoas falando sobre isso” do Facebook. Inteiro; vazio quando não exibido.	918893

Linhas de exemplo:

username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about
4,yes,https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg,4,zuck,Mark Zuckerberg,https://scontent.xx.fbcdn.net/v/....jpg?...&oe=...,Bringing the world closer together.,121439077,918893
zzqqxxjjkk993827a,no,,,,,,,,

Perfis pessoais e páginas (Pages) são suportados. Por exemplo, Meta é resolvido para fb_id 100080376596424 e seu valor de followers é o número de curtidas da página.

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.
Preço: US$ 3 por 10.000 identificadores. A cobrança é pela quantidade enviada: cada identificador enviado é cobrado, com ou sem perfil encontrado. A quantidade mínima cobrada por tarefa é de 500 identificadores; tarefas menores são cobradas como 500.
Os resultados refletem a página pública do perfil no momento da verificação. Nenhum cache é aplicado; cada envio é verificado novamente.
Verifique os limites de entrada do produto antes de enviar.
Linhas com falha aparecem no resultado exportado e nos contadores.
Os campos acima se baseiam na amostra atual e podem mudar se a estrutura da página de origem mudar.