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 です。サービス料を含みます。