Your Snapchat ad account performance — spend, swipes
snapchat-ads.queryGet spend, impressions and swipes for your whole Snapchat ad account
- 가격
- free정가 기준
- 성공률
- —성공률 데이터가 아직 없습니다성공률 데이터가 아직 없습니다
- 지연 시간 p50
- ——
- 마지막 검증
- —아직 검증되지 않음
GEThttps://toolswitch.dev/v1/tools/snapchat-ads.queryBeta- 플랫폼 할당량 사용
- 동기 응답
- 공개 데이터 읽기
파라미터
spend is in MICRO-CURRENCY: 1000000 = 1 unit of the account currency. `swipes` is Snapchat's click. Hourly granularity is capped at a short window (about 7 days) and TOTAL/DAY at roughly 31 days per request — a longer range is an error, not a truncated result
| 파라미터 | 유형 | 필수 | 설명 | 예시 |
|---|---|---|---|---|
| 경로 파라미터 | ||||
ad_account_id | 문자열 | 필수 | UUID | 8adc3db7-8148-4fbf-999c-8d2266369d74 |
| 쿼리 파라미터 | ||||
fields | 문자열 | 선택 | comma-separated metrics; omitting it returns only impressions and spend | impressions,swipes,spend,video_views,conversion_purchases,screen_time_millis |
end_time | 문자열 | 선택 | ISO 8601, same alignment rule; exclusive | 2026-07-28T00:00:00-07:00 |
breakdown | 문자열 | 선택 | campaign | adsquad | ad — returns one stats row per child entity instead of one account total | campaign |
start_time | 문자열 | 선택 | ISO 8601 WITH offset and aligned to midnight in the AD ACCOUNT's timezone — 2026-06-28T00:00:00-07:00. A non-midnight or wrong-offset value is rejected outright; required for DAY/HOUR | 2026-06-28T00:00:00-07:00 |
granularity | 문자열 | 필수 | TOTAL | DAY | HOUR | LIFETIME | DAY |
view_attribution_window | 문자열 | 선택 | 1_HOUR | 3_HOUR | 6_HOUR | 1_DAY (default) | 7_DAY | 28_DAY | |
swipe_up_attribution_window | 문자열 | 선택 | 1_DAY | 7_DAY (default) | 28_DAY | 28_DAY |
- 경로 파라미터
ad_account_id문자열필수UUID
예시:
8adc3db7-8148-4fbf-999c-8d2266369d74- 쿼리 파라미터
fields문자열선택comma-separated metrics; omitting it returns only impressions and spend
예시:
impressions,swipes,spend,video_views,conversion_purchases,screen_time_millisend_time문자열선택ISO 8601, same alignment rule; exclusive
예시:
2026-07-28T00:00:00-07:00breakdown문자열선택campaign | adsquad | ad — returns one stats row per child entity instead of one account total
예시:
campaignstart_time문자열선택ISO 8601 WITH offset and aligned to midnight in the AD ACCOUNT's timezone — 2026-06-28T00:00:00-07:00. A non-midnight or wrong-offset value is rejected outright; required for DAY/HOUR
예시:
2026-06-28T00:00:00-07:00granularity문자열필수TOTAL | DAY | HOUR | LIFETIME
예시:
DAYview_attribution_window문자열선택1_HOUR | 3_HOUR | 6_HOUR | 1_DAY (default) | 7_DAY | 28_DAY
swipe_up_attribution_window문자열선택1_DAY | 7_DAY (default) | 28_DAY
예시:
28_DAY
코드 예제
$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.
curl -X GET 'https://toolswitch.dev/v1/tools/snapchat-ads.query' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/snapchat-ads.query",
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.query", {
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());게이트웨이 API는 Beta이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 free이며 서비스 수수료가 포함되어 있습니다.