Biblioteca de Anúncios da Meta do zero: identidade, app e token

Para que serve no AFK

• Validar demanda: quando o AFK valida um termo ("valida a demanda de bolo de pote"), ele conta os anúncios ativos com esse termo e usa o número na nota da ideia.
• O limite que importa: a API só traz anúncio de qualquer assunto quando ele rodou no Reino Unido ou na União Europeia. Anúncio que rodou só no Brasil volta apenas se for de política, eleição ou causa social. Para loja, serviço e negócio local, quase sempre o número vem baixo ou zero.
• Sem o cartão: o AFK valida a demanda do mesmo jeito, com as outras fontes (buscas do Google, tendências e conversas). Este sinal fica de fora.

Para a maioria dos negócios no Brasil, este cartão não compensa o trabalho. Ligue se o seu nicho anuncia na Europa ou se você trabalha com política e causa social.

Antes: grátis, mas com confirmação de identidade

As páginas oficiais da Meta não citam cobrança pela API. As regras podem mudar: confira em facebook.com/ads/library/api.

Parte 1: ligar a verificação em duas etapas

1. No Facebook, clique na sua foto, no canto superior direito → Configurações e privacidade → Configurações.
2. Clique em Central de Contas → Senha e segurança → Autenticação de dois fatores.
3. Escolha a conta e o método app de autenticação. Guarde os códigos de recuperação fora do computador.

Parte 2: confirmar identidade e localização

1. Entre no Facebook e abra facebook.com/ID.
2. Siga as etapas que a tela pedir. É a mesma confirmação que a Meta exige de quem anuncia sobre política e causa social.
3. Espere a resposta. A Meta avisa que pode levar alguns dias. Sem essa confirmação, o token não consulta a API.

Parte 3: virar desenvolvedor e criar o app

O painel de desenvolvedor da Meta costuma aparecer em inglês. Quando o nome do botão muda com o idioma da sua conta, os dois aparecem abaixo.

1. Abra developers.facebook.com/async/registration. Aceite os termos, digite o código que chega no seu celular e no seu e-mail e escolha a profissão.
2. Abra facebook.com/ads/library/api e clique em Acessar a API. Ou vá direto a developers.facebook.com/apps e clique em Create App.
3. Dê um nome ao app, por exemplo Minha Empresa Pesquisa, e o e-mail que você lê. Nas outras perguntas, escolha a opção mais simples que a tela oferecer: este app não publica nada nem pede permissão de cliente.

Parte 4: gerar o token e estender

O token que o Explorador gera vence em poucas horas. Estenda antes de colar no AFK, senão a consulta para no mesmo dia.

1. Abra o Explorador da Graph API.
2. No canto superior direito, em App da Meta (Meta App), escolha o app da parte 3. Em Usuário ou Página (User or Page), deixe o token de usuário.
3. Clique em Generate Access Token (em português, Obter token de acesso) e confirme na janela que abrir.
4. Copie o token que aparece no campo do canto superior direito.
5. Abra o Depurador de Token de Acesso, cole o token e clique em Depurar (Debug).
6. No resultado, use o botão de estender o token de acesso. Copie o token novo que aparece. Ele dura cerca de 60 dias.

Parte 5: colar no AFK

No painel do AFK, abra Conexões, clique no cartão Biblioteca de Anúncios da Meta, cole em Token de acesso da Meta e clique em Salvar conexão.

Este cartão não tem o botão Testar. Para conferir, diga ao AFK: "valida a demanda de bolo de pote". Na linha do termo, o campo ads: mostra um número (mesmo que seja 0). Se mostrar ads:—, a Meta não respondeu: veja os erros abaixo.

No dia a dia

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande o token.

Fontes oficiais (conferido em 30/10/2026): facebook.com/ads/library/api (o que a API cobre: política e causa social no mundo todo, qualquer anúncio no Reino Unido e na União Europeia; etapas facebook.com/ID, conta de desenvolvedor e app; botão Acessar a API; token obrigatório; Explorador da Graph API; erro 1357045 e bloqueador de anúncios; até 5 mil anúncios por página de resultado) · developers.facebook.com/docs/graph-api/reference/ads_archive (anúncio que não chegou à União Europeia só volta se for de política e causa social; ad_type padrão ALL; erros 190, 613, 100) · developers.facebook.com/docs/graph-api/guides/explorer (gerar token de usuário no Explorador; menus App da Meta e Usuário ou Página) · developers.facebook.com/docs/facebook-login/guides/access-tokens/get-long-lived (token de usuário curto vence em horas; o longo dura cerca de 60 dias) · developers.facebook.com/tools/debug/accesstoken (Depurador de Token de Acesso, botão Depurar) · developers.facebook.com/documentation/development/register (inscrição de desenvolvedor) · developers.facebook.com/docs/graph-api/guides/error-handling (código 10 permissão, código 190 token) · facebook.com/help/148233965247823 (autenticação de dois fatores).