通过一个 API 管理已连接广告账户中的付费广告活动
广告账户只需连接一次，与各网络的对接由 FoPost 代劳。把表现好的帖子变成广告，管理广告活动层级，暂停效果不佳的部分，并以统一的格式拉取数据洞察，无论广告投放在哪个网络。
curl -X POST https://api.fopost.com/v1/ads/boost \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"adAccountId": "act_1234567890",
"postId": "7d3e0a52-...",
"accountId": "4a71d80b-...",
"name": "Boost: launch day",
"goal": "engagement",
"budget": { "minor": 2000, "type": "daily" },
"targeting": { "countries": ["US", "CA"], "ageMin": 25, "ageMax": 54, "gender": "all" }
}'
{
"data": {
"id": "c1d8e4b6-...", "kind": "boost", "name": "Boost: launch day", "goal": "engagement",
"status": "paused", "effectiveStatus": "PAUSED", "platform": "instagram-business",
"sourcePostId": "7d3e0a52-...", "budgetMinor": 2000, "budgetType": "daily",
"currency": "USD", "insights": null, "lastError": null, "createdAt": "2026-11-12T10:04:51Z"
}
}推广帖子
推广已发布的帖子，无需重新制作素材。
默认暂停
除非传入 paused: false，否则新广告创建后处于暂停状态。
统一的洞察格式
展示、触达、点击、花费、CTR 和潜在客户，在每个网络上都一致。
你的团队已在使用的广告网络
Meta、Google、LinkedIn、TikTok、Pinterest 和 X 的广告账户通过各网络自己的登录方式连接。GET /v1/ads/providers 列出每个网络及其支持的功能；推广适用于发布到 Facebook、Instagram、LinkedIn、TikTok、Pinterest 和 X 的帖子。Google 没有可推广的帖子，因此其广告需要创建，而不是推广。
阅读连接接口参考
各网络的能力
每个服务商会说明自己是否提供推广、潜在客户表单、像素等功能。
也支持现有广告
GET /v1/ads/external 列出在网络自带管理后台中创建的广告。
限定于工作区
一个连接只属于一个工作区，且只能从该工作区访问。
广告活动、广告组、广告、素材与受众
当推广不够用时，可构建完整的层级：POST /v1/ads/campaigns、/v1/ads/ad-sets 和 /v1/ads/ads，并配套素材与已保存的受众。在各网络支持的范围内，目标涵盖互动、流量、知名度、视频观看、消息、通话、WhatsApp 和销售。一次调用最多可暂停或恢复 50 个对象。
查看广告活动接口curl -X POST https://api.fopost.com/v1/ads/status \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspaceId": "9b2f6c1e-...",
"connectionId": "3f6a9d27-...",
"status": "paused",
"objects": [
{ "id": "120210000000001", "level": "campaign" },
{ "id": "120210000000042", "level": "ad_set" }
]
}'
{
"data": [
{ "id": "120210000000001", "level": "campaign", "ok": true, "error": null },
{ "id": "120210000000042", "level": "ad_set", "ok": true, "error": null }
]
}复制
复制广告活动、广告组或广告。副本默认处于暂停状态。
受众
创建已保存的受众，并搜索网络提供的定向选项。
花费需要 publish
启动、推广、暂停或删除需要 publish 范围。
无需逐个学习各家报表 API，即可读取效果
GET /v1/ads/insights 接收对象 ID 和日期范围，返回汇总数据、可选的按年龄、性别、版位或国家的细分，以及每日时间线。花费以广告账户的货币计，使用最小单位。对于 Google Ads，POST /v1/ads/insights/query 会针对已连接的客户运行 Google Ads 查询。
阅读洞察接口参考curl "https://api.fopost.com/v1/ads/insights?workspace_id=9b2f6c1e-...&connection_id=3f6a9d27-...&object_id=120210000000001&since=2026-11-01&until=2026-11-11&breakdown=country" \
-H "X-API-Key: $API_KEY"
{
"data": {
"objectId": "120210000000001", "currency": "USD",
"since": "2026-11-01", "until": "2026-11-11", "breakdownBy": "country",
"totals": { "impressions": 48210, "reach": 31977, "clicks": 1204, "spendMinor": 22000, "ctr": 2.5, "leads": 0 },
"breakdown": [{ "key": "US", "metrics": { "impressions": 39102, "clicks": 1003, ... } }],
"timeline": []
}
}任意日期范围
since 和 until 按广告账户所在时区计算；添加 daily=true 可获得时间线。
刷新广告
POST /v1/ads/:id/refresh 拉取当前状态和累计数据。
最小单位
预算和花费为以货币最小单位计的整数。
潜在客户、广告评论与转化追踪
在 Meta 和 LinkedIn 上创建潜在客户表单，并读取每个表单收集的潜在客户。订阅某个主页后，其新增潜在客户会在网络上报时出现在 GET /v1/ads/leads 中。在 TikTok 上，可读取广告下的评论并回复或隐藏。可管理 Meta、LinkedIn 和 TikTok 的像素，并将转化事件回传给网络。
开始构建
潜在客户流
汇集所有已订阅主页的潜在客户，分页返回为一个列表。
广告评论
适用于 TikTok 广告的 POST /v1/ads/comments/:id/reply 和 /hide。
像素
创建、共享像素，并读取其统计数据与匹配质量。