GET /v1/ads/campaigns
const url = 'https://seu-endereco-da-api/v1/ads/campaigns?period=7&window=current';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://seu-endereco-da-api/v1/ads/campaigns?period=7&window=current' \ --header 'Authorization: Bearer <token>'Permissão que a Chave de acesso precisa: Ler Meta Ads (ads:read).
Authorizations
Seção intitulada “Authorizations”Parameters
Seção intitulada “Parameters”Query Parameters
Seção intitulada “Query Parameters”Conta conectada do tenant (exclusivo com adId)
Id numérico do anúncio na Meta; devolve a árvore da conta dona com focus
Responses
Seção intitulada “Responses”object
object
Só dígitos; o act_ é prefixo de rota
Reatualizado a cada leitura fresca da árvore na Meta
Falso quando as insights da Meta falharam; gasto e cliques vêm null
Caminho do anúncio pedido por adId
object
object
object
Centavos da moeda da conta
object
Centavos da moeda da conta
Pessoas únicas; só no anúncio — conjunto e campanha devolvem null, porque somar alcance conta a mesma pessoa duas vezes
Escala de Deal.value
Centavos da moeda da conta
Razão com duas casas
object
object
Centavos da moeda da conta
object
Centavos da moeda da conta
Pessoas únicas; só no anúncio — conjunto e campanha devolvem null, porque somar alcance conta a mesma pessoa duas vezes
Escala de Deal.value
Centavos da moeda da conta
Razão com duas casas
object
object
Centavos da moeda da conta
Pessoas únicas; só no anúncio — conjunto e campanha devolvem null, porque somar alcance conta a mesma pessoa duas vezes
Escala de Deal.value
Centavos da moeda da conta
Razão com duas casas
Example
{ "account": { "metaStatus": "active", "tokenStatus": "valid", "missingScopes": [ "ads_read" ] }, "period": "7", "campaigns": [ { "status": "ACTIVE", "effectiveStatus": "ACTIVE", "budget": { "kind": "daily" }, "adsets": [ { "status": "ACTIVE", "effectiveStatus": "ACTIVE", "budget": { "kind": "daily" }, "ads": [ { "status": "ACTIVE", "effectiveStatus": "ACTIVE" } ] } ] } ]}