Meta Ads - Campanhas

Permite buscar dados de tráfego, orçamentos, custos de campanhas, conjuntos de anúncios (AdSets) e anúncios ativos no Facebook Ads/Meta Ads.

Endpoint

GET https://api.integraon.com.br?versao=v1&token={token}&servico=meta-ads&recurso=campanha

Parâmetros do Body (JSON)

Campo Tipo Obrigatoriedade Descrição
data_inicial string Obrigatório Data de início (Formato: YYYY-MM-DD).
data_final string Obrigatório Data final (Formato: YYYY-MM-DD). Intervalo máximo permitido: 31 dias.

Particularidades de Retorno (Imposto / Gasto)

Diferente de outras plataformas, o Meta Ads calcula e expõe dois campos de custo no nível do anúncio criativo:

Exemplo de Resposta (Meta Ads) 
{
  "2026-06-01": {
    "act_123456789": {
      "id": "act_123456789",
      "nome": "Conta Meta Ads 01",
      "status": "ativo",
      "campanhas": {
        "1111222233": {
          "id": "1111222233",
          "nome": "Meta - Conversão Tráfego",
          "orcamento": 50.00,
          "status": "ativo",
          "impressoes": 30000,
          "cliques": 1200,
          "ctr": 4.0,
          "cpc": 0.41,
          "valor_gasto": 492.00,
          "data_atualizacao": "2026-06-01 23:59:59",
          "gruposAnuncios": {
            "44445555": {
              "id": "44445555",
              "nome": "Conjunto - Lookalike",
              "status": "ativo",
              "impressoes": 15000,
              "cliques": 600,
              "ctr": 4.0,
              "cpc": 0.41,
              "valor_gasto": 246.00,
              "anuncios": {
                "99998888": {
                  "id": "99998888",
                  "nome": "Ad - Video Reels",
                  "status": "ativo",
                  "impressoes": 7500,
                  "cliques": 300,
                  "ctr": 4.0,
                  "cpc": 0.41,
                  "valor_gasto": 123.00,
                  "valor_gasto_sem_imposto": 100.00,
                  "link": "https://site.com/url-final",
                  "trackeamento": {
                    "utm_source": "facebook",
                    "utm_medium": "cpc",
                    "utm_campaign": "meta_junho"
                  },
                  "data_atualizacao": "2026-06-01 23:59:59"
                }
              }
            }
          }
        }
      }
    }
  }
}
Simulador de Requisição: Meta Ads
Comando Curl Gerado 
Aguardando parâmetros...