One Snapchat campaign's performance — spend, swipes
snapchat-ads.campaign.statsGet spend, impressions and swipes for one Snapchat campaign
- Preço
- freePelo preço de tabela
- Taxa de sucesso
- —Ainda não há dados da taxa de sucessoAinda não há dados da taxa de sucesso
- Latência p50
- ——
- Última verificação
- —Ainda não verificado
GEThttps://toolswitch.dev/v1/tools/snapchat-ads.campaign.statsBeta- Usa a cota da plataforma
- Resposta síncrona
- Lê dados públicos
Parâmetros
identical shape to the account-level report, scoped to one campaign; /adsquads/{id}/stats and /ads/{id}/stats are the same again further down. LIFETIME granularity ignores start_time/end_time and returns the campaign's all-time totals
| Parâmetro | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| Parâmetros de caminho | ||||
campaign_id | string | Obrigatório | UUID from the campaigns list | 92e1c28a-a331-45b4-8c26-fd3e0eea8c39 |
| Parâmetros de consulta | ||||
fields | string | Opcional | impressions,swipes,spend,conversion_purchases,attachment_total_view_time_millis | |
end_time | string | Opcional | 2026-07-28T00:00:00-07:00 | |
breakdown | string | Opcional | adsquad | ad — one row per child of this campaign | adsquad |
start_time | string | Opcional | ISO 8601 aligned to ad-account-timezone midnight | 2026-06-28T00:00:00-07:00 |
granularity | string | Obrigatório | TOTAL | DAY | HOUR | LIFETIME | TOTAL |
swipe_up_attribution_window | string | Opcional | 7_DAY | |
- Parâmetros de caminho
campaign_idstringObrigatórioUUID from the campaigns list
Exemplo:
92e1c28a-a331-45b4-8c26-fd3e0eea8c39- Parâmetros de consulta
fieldsstringOpcionalExemplo:
impressions,swipes,spend,conversion_purchases,attachment_total_view_time_millisend_timestringOpcionalExemplo:
2026-07-28T00:00:00-07:00breakdownstringOpcionaladsquad | ad — one row per child of this campaign
Exemplo:
adsquadstart_timestringOpcionalISO 8601 aligned to ad-account-timezone midnight
Exemplo:
2026-06-28T00:00:00-07:00granularitystringObrigatórioTOTAL | DAY | HOUR | LIFETIME
Exemplo:
TOTALswipe_up_attribution_windowstringOpcionalExemplo:
7_DAY
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
curl -X GET 'https://toolswitch.dev/v1/tools/snapchat-ads.campaign.stats' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/snapchat-ads.campaign.stats",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/snapchat-ads.campaign.stats", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());Esta API de gateway está em Beta; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a free, incluindo a taxa de serviço.