連携した広告アカウントの有料キャンペーンを、ひとつの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件のオブジェクトを1回の呼び出しで一時停止または再開できます。
キャンペーンのエンドポイントを見る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でピクセルを管理し、コンバージョンイベントをネットワークに送り返せます。
構築を始める
リードフィード
購読しているすべてのページのリードを、ページネーション付きの1つのリストで。
広告コメント
TikTok広告向けの POST /v1/ads/comments/:id/reply と /hide。
ピクセル
ピクセルの作成、共有、統計とマッチ品質の取得ができます。