Your Meta ads' spend, impressions, clicks, conversions
meta-ads.insightsGet spend, impressions, clicks and conversions for your Meta ads
- Price
- freeプロバイダー原価
- Success rate
- —成功率データはまだありません成功率データはまだありません
- Latency p50
- ——
- Last verified
- 2026/07/28Verified working
GEThttps://toolswitch.dev/v1/tools/meta-ads.insights?limit=2&date_preset=last_7dPreview- Uses platform quota
- Synchronous response
- Reads public data
パラメータ
conversions are NOT top-level fields: they arrive inside `actions` as [{action_type, value}] and you pick the action_type that matches the campaign's objective (purchase, lead, link_click). Attribution defaults to the ad account's setting unless action_attribution_windows is passed. A large request answers with a report_run_id for async polling instead of data
| パラメータ | 型 | 必須 | 説明 | 例 |
|---|---|---|---|---|
| パスパラメータ | ||||
object_id | 文字列 | 必須 | ANY level of the hierarchy: act_… for the whole account, or a campaign / ad set / ad id to scope it down | act_1234567890 |
| クエリパラメータ | ||||
level | 文字列 | 任意 | account | campaign | adset | ad — the granularity of the ROWS returned, independent of object_id | campaign |
limit | 整数 | 任意 | 100 | |
fields | 文字列 | 必須 | comma-separated metrics | spend,impressions,clicks,ctr,cpc,cpm,reach,frequency,actions,action_values |
breakdowns | 文字列 | 任意 | e.g. age,gender or publisher_platform — not every breakdown combines with every metric | publisher_platform |
time_range | 文字列 | 任意 | JSON as a string: {"since":"2026-07-01","until":"2026-07-28"} | |
date_preset | 文字列 | 任意 | today | yesterday | last_7d | last_14d | last_30d | this_month | maximum — mutually exclusive with time_range | last_30d |
time_increment | 文字列 | 任意 | 1 for a daily series; omit for one aggregate row | 1 |
- パスパラメータ
object_id文字列必須ANY level of the hierarchy: act_… for the whole account, or a campaign / ad set / ad id to scope it down
例：
act_1234567890- クエリパラメータ
level文字列任意account | campaign | adset | ad — the granularity of the ROWS returned, independent of object_id
例：
campaignlimit整数任意例：
100fields文字列必須comma-separated metrics
例：
spend,impressions,clicks,ctr,cpc,cpm,reach,frequency,actions,action_valuesbreakdowns文字列任意e.g. age,gender or publisher_platform — not every breakdown combines with every metric
例：
publisher_platformtime_range文字列任意JSON as a string: {"since":"2026-07-01","until":"2026-07-28"}
date_preset文字列任意today | yesterday | last_7d | last_14d | last_30d | this_month | maximum — mutually exclusive with time_range
例：
last_30dtime_increment文字列任意1 for a daily series; omit for one aggregate row
例：
1
コード例
$TOOLSWITCH_KEY をコンソールで作成したキーに置き換えてください。
curl -X GET 'https://toolswitch.dev/v1/tools/meta-ads.insights?limit=2&date_preset=last_7d' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/meta-ads.insights?limit=2&date_preset=last_7d",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/meta-ads.insights?limit=2&date_preset=last_7d", {
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 はプレビュー版です。URL や認証方式は変更される場合があります。 パラメータはサンプルデータです。 呼び出し料金は free です。サービス料を含みます。