API do Meta Ads: dados das campanhas dos seus clientes no seu produto

Conecte as contas de anúncio do Facebook e do Instagram dos seus clientes e consulte investimento, alcance, cliques e conversões por uma API. Sem criar app na Meta e sem pedir acesso à Marketing API.

Começar teste grátis Ver documentação

15 dias para testar. Sem cartão de crédito.

POST /api/metrics/get-data

{
  "customer_integration": "<conta conectada>",
  "start": "2026-09-01",
  "end": "2026-09-30",
  "metrics": [{
    "id": "m1",
    "reference_key": "fb_ads:reach",
    "component": "number_v1"
  }]
}

Meta Ads do seu cliente

Alcance total

46.847

Exemplo de consulta: alcance de uma conta de Meta Ads conectada em setembro.

Pela API oficial do Meta Ads

O que vem antes do primeiro dado.

Criar um app no Meta for Developers e adicionar a Marketing API.
Pedir acesso avançado à permissão de leitura de anúncios e passar pela revisão de app.
Concluir a verificação da empresa e respeitar os limites de chamadas por conta de anúncio.
Renovar os tokens e adaptar o código a cada nova versão da API.

Pelo Reportei Connect

Uma integração já aprovada e mantida.

Seu cliente autoriza a conta numa tela pronta, hospedada pelo Connect.
Você consulta as métricas por uma API REST, com a mesma chave para todas as plataformas.
O Connect renova os tokens e avisa seu sistema por webhook quando uma conexão perde o acesso.
A resposta tem o mesmo formato nas 50 integrações do catálogo.

Dados disponíveis

O que você consulta no Meta Ads.

Alguns exemplos do catálogo. A lista completa de métricas e dimensões está no Connect Explorer, onde você testa a consulta numa conta real antes de escrever código.

Também cria campanhas

Além de ler métricas, a API do Connect cria e gerencia campanhas, conjuntos e anúncios nas contas de Meta Ads conectadas.

Valor investido
Alcance, impressões e frequência
Cliques, CTR e CPC médio
CPM médio
Compras no Facebook e no Instagram
Custo por contato no site
Resultados por campanha, conjunto e anúncio

Quem usa

O Meta Ads dentro do seu produto.

Custo por lead no seu CRM
A Leadster cruzou investimento do Meta Ads, Google Ads e LinkedIn Ads com os leads dos chatbots e passou a mostrar o custo por conversão de cada canal.
Dashboards para agências
Entregue o resultado das campanhas dentro do seu software, junto com os dados que só você tem.
Agentes de IA
Dê ao seu agente as métricas reais das contas para ele analisar, comparar períodos e sugerir ajustes.

Perguntas sobre a API do Meta Ads

Dá para filtrar por campanha, conjunto ou anúncio?

Sim. As consultas aceitam o ID e o tipo da entidade (campanha, conjunto ou anúncio) para filtrar os resultados.

Preciso pedir acesso à Marketing API?

Não. A integração do Connect já tem os acessos aprovados pela Meta. Seu cliente autoriza a conta de anúncio e você consulta pela API do Connect.

Quanto custa?

O plano do Connect inclui um número de conexões e cobra um valor fixo por conexão adicional, igual em qualquer plataforma do catálogo. Cada conta conectada por um cliente seu conta como uma conexão. Os valores atualizados estão na seção de preços da página inicial. Você testa por 15 dias sem cartão de crédito.

Meu cliente precisa ter conta no Reportei?

Não. Seu sistema gera um link de conexão, o cliente autoriza as contas numa tela pronta do Connect e continua usando só o seu produto.