Campaigns in your Meta ad account — status, budget
meta-ads.campaignsList the campaigns in your Meta ad account with status, objective and budget
- 价格
- free按供应商原价
- 成功率
- —暂无成功率数据暂无成功率数据
- 延迟 p50
- ——
- 最后验证
- 2026年7月28日实测可用
GEThttps://toolswitch.dev/v1/tools/meta-ads.campaigns?limit=2预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
budgets are strings in the account currency's MINOR unit — daily_budget "5000" is $50.00. Budget can live on the campaign (CBO) or on each ad set, so a null daily_budget here is normal, not missing data. Ad sets and ads are the same pattern on /{ad_account_id}/adsets and /ads
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 路径参数 | ||||
ad_account_id | 字符串 | 必填 | the act_-prefixed id from facebook.ads.accounts | act_1234567890 |
| 查询参数 | ||||
after | 字符串 | 可选 | paging.cursors.after from the previous response | |
limit | 整数 | 可选 | 50 | |
fields | 字符串 | 必填 | id,name,status,effective_status,objective,daily_budget,lifetime_budget,start_time,stop_time,created_time | |
effective_status | 字符串 | 可选 | JSON array as a string, e.g. ["ACTIVE","PAUSED"] — without it Meta also returns archived campaigns | ["ACTIVE"] |
- 路径参数
ad_account_id字符串必填the act_-prefixed id from facebook.ads.accounts
示例：
act_1234567890- 查询参数
after字符串可选paging.cursors.after from the previous response
limit整数可选示例：
50fields字符串必填示例：
id,name,status,effective_status,objective,daily_budget,lifetime_budget,start_time,stop_time,created_timeeffective_status字符串可选JSON array as a string, e.g. ["ACTIVE","PAUSED"] — without it Meta also returns archived campaigns
示例：
["ACTIVE"]
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/meta-ads.campaigns?limit=2' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/meta-ads.campaigns?limit=2",
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.campaigns?limit=2", {
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());网关接口为预览版，地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 free 计费，已含服务费。