Taboola APIガイド: Backstageのエンドポイント、認証、実際の活用例

Taboola API（正式名称Backstage API）は、Taboolaが広告主向けに提供するRESTインターフェースです。OAuth 2.0クライアント認証情報で認証し、Ads Consoleで操作できるすべての項目（キャンペーン、クリエイティブ、ターゲティング、予算、パフォーマンスレポート）をhttps://backstage.taboola.com/backstage/api/1.0/{account_id}/…の下で読み書きできます。メディアバイヤーはこのレイヤーを使って入札や予算の変更を自動化したり、クリエイティブを一括アップロードしたり、支出をデータウェアハウスに同期したり、TaboolaのUIでは提供されないルールエンジンを構築したりします。このAPIが意図的に公開しないのは他社のデータです——ネットワーク全体の競合ビューを得るにはまったく別のAPIが必要であり、それについては最後に説明します。

Backstage APIがカバーする範囲#

Backstageは広告主コンソールとほぼ一対一で対応しています。実際にほとんどの作業を担うのは以下の4つの領域です：

• キャンペーン管理。 キャンペーンの作成、読み取り、更新、一時停止。CPC、日次・総予算、地理/プラットフォームターゲティング、サイトブロッキングの設定。夜間の数値を確認して午前7時に手動で変更していた作業をスクリプト化できます。
• アイテム（クリエイティブ）。 各キャンペーンにはアイテム（実際に配信される画像＋見出しのユニット）が含まれます。APIを使えばアイテムを一括追加、ステータス更新、アイテムごとのレビュー状態の読み取りが可能で、大規模アカウントはUIに触れずに数十のクリエイティブバリエーションを展開できます。（まだ手動で最初のキャンペーンを設定している場合は、Taboolaキャンペーン設定ウォークスルーから始めてください——APIはコンソールの概念をすでに理解していることを前提としています。）
• レポート。 日、キャンペーン、サイト、国、プラットフォーム、アイテムなどのディメンションで集計されたパフォーマンスエンドポイント——自動最適化のための生データです。
• 辞書。 他のすべてのエンドポイントが依存する列挙型（国コード、プラットフォーム、オーディエンスセグメント）を検索するためのエンドポイント。

アクセスはアカウントに対して発行されるクライアントIDとシークレットとして提供され（これまではTaboolaのアカウントマネージャーを通じてリクエスト）、公式Backstageリファレンスが現在のエンドポイント形状とアクセス手順の信頼できる情報源です。以下のエンドポイントパスは本記事執筆時点のものです；構築前にリファレンスで確認してください。

認証：クライアント認証情報からベアラートークンへ#

Backstageは標準的なOAuth 2.0クライアント認証情報フローを使用します。IDとシークレットをトークンと交換します：

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

レスポンスにはaccess_tokenが含まれ、これをすべての呼び出しでベアラーヘッダーとして送信します：

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

このallowed-accounts呼び出しは最初に行うべきリクエストです：他のすべてのエンドポイントがパスに必要とするaccount_id値（数値IDと読み取り可能な名前）が返されます。トークンには有効期限があります——401が返されたらキャッシュしてリフレッシュするようにし、リクエストごとに新しいトークンを生成しないでください。レイテンシの理由と、トークンリクエストはデータリクエストよりも厳しくレート制限されるためです。

実際に使用するエンドポイント#

レポートエンドポイントはstart_dateとend_dateのクエリパラメータとオプションのフィルタを受け取り、dimensionセグメント（day、campaign_breakdown、site_breakdown、country_breakdown、platform_breakdown…）でスライスを決定します。site_breakdownは最適化において最も重要なものです：ブロックリストの自動化を駆動するパブリッシャー別のパフォーマンスフィードです。

メディアバイヤーが実際に自動化していること#

APIは次の4つの定期的なジョブで導入コストを回収します：

1. ルールエンジン。 古典的な例：1時間ごとにアクティブキャンペーンのsite_breakdownを取得し、目標CPAのN倍以上を費やしてコンバージョンがゼロのサイトを、キャンペーン更新を介してブロックサイトリストに追加します。これはすべての真剣なTaboola広告主が手動で行っている「損失を削減する」ループをコード化したもので、感情に左右されず、午前3時にも実行されます。
2. 入札管理。 目標を上回る日や地域ではキャンペーンCPC（および利用可能なサイト別入札調整）を引き上げ、CPAが逸脱したら引き下げる——小さく、頻繁で、退屈な調整が積み重なります。
3. 一括クリエイティブ操作。 キャンペーンごとに30の見出し/画像バリアントをアップロードし、週間中央値CTR以下のものをすべて一時停止し、クリエイティブローテーションを疲労の前に維持する——午後のクリック作業なしで。
4. 支出パイプライン。 毎晩のジョブでcampaign-summaryを日別にデータウェアハウスに取り込み、Taboolaの支出をコンバージョン収益や他のすべてのチャネルと一つのダッシュボードで並べられるようにします。

最小限の統合計画#

ゼロから始める場合、以下の手順で約1日で実用的な自動化に到達でき、各ステップは次の前に検証可能です：

1. トークンのラウンドトリップ。 認証情報をトークンと交換し、allowed-accountsを呼び出します。これが動作すれば、認証と権限は解決です。
2. 読み取り専用レポート。 過去1週間のcampaign-summaryを日別に取得し、Ads Consoleの数値と照合します。読み取りがUIと一致するまでは何も書き込まないでください。
3. 単一の安全な変更。 PUTを介して1つのテストキャンペーンを一時停止および再開します。変更がコンソールに反映され、配信状態が追従することを確認します。
4. 毎晩の支出同期。 レポート取得をデータベースにスケジュールします。これだけでほとんどのチームにとって統合が正当化されます。
5. ルールエンジンのドライラン。 サイトブロックの判断を計算し、何が起こるかを1週間ログに記録してから書き込みを許可します。その判断を手動で行ったものと比較することは、これまでで最も安価なQAです。

いきなりステップ5に飛ぶのが典型的なミスです——実際の広告アカウントに対する書き込みパスのバグは高くつく教訓です。

レート制限と実用的な注意点#

• 上限を尊重する。 Backstageはアカウントごとのレート制限を実施しています；読み取りをバッチ化し（キャンペーンごとに毎分ではなく毎時1回のレポート呼び出し）、429が返されたらバックオフします。現在の制限は想定せずにリファレンスで確認してください。
• レポートは配信に遅延する。 直近時間のデータは時間とともに確定します；少なくとも数時間前のデータに対してルールを構築するか、不完全な数値でキャンペーンを一時停止しないようにしてください。
• 編集は即時ではない。 キャンペーンの変更は配信に伝播するまで遅延があり、アイテムの編集はレビューを再トリガーする可能性があります。自動化はギャップを許容し、"失敗"した書き込みを再発行しないようにする必要があります。
• IDを保存し、名前は保存しない。 キャンペーン名やアイテム名は人間が編集します；数値IDは安定した結合キーです。
• 書き込みパスを保護する。 バグのあるルールエンジンはアカウントの全支出を一時停止したり、入札を10倍にしたりする可能性があります。すべての変更をログに記録し、健全性の範囲を追加し（1回のパスで入札をX%以上変更しない）、新しいルールは必ずドライランモードで開始してください。

もう一つのTaboola API：競合データ#

上記のすべては、まさに一つのアカウント——あなたのアカウント——のみを対象としています。Backstageは、どの広告主があなたの業種でスケーリングしているか、どのようなクリエイティブを実行しているか、競合のキャンペーンがどれだけ存続したかを決して教えてくれません——ネットワークは独自の広告ライブラリを公開しておらず、他社のアクティビティを公開する公式エンドポイントもありません。

そのギャップを埋めるのがOpenAdLibraryの開発者APIです。インデックスには206,000以上のアクティブなTaboolaクリエイティブ（2026年7月時点）が49のネットワークにわたる725,000以上のネイティブ広告のコーパス内に保持されており、Taboola広告ライブラリの背後にある同じデータがREST経由でクエリ可能です：広告主、業種、地域、掲載期間でクリエイティブを検索；見出しやランディングページを取得；競合がキャンペーンを開始・終了するタイミングを追跡します。ネイティブ広告データAPIガイドでエンドポイントを説明しており、ワークフローがLLMエージェント内で動作する場合は、同じコーパスをClaudeやChatGPT用のツールとして公開するMCPサーバーもあります。無料キーで軽い利用が可能で、価格はそれ以外も定額です；プログラマティック広告インテリジェンスアクセスのより広い状況はAPIを備えたアドスパイツールで概説されています。

2つのAPIは自然に組み合わさります：Backstageは自社アカウントでの実行を自動化し、インテリジェンスAPIは他社の調査を自動化します。自動化を最大限活用しているバイヤーは両方を実行しています——自社のキャンペーンを整頓するルールエンジンと、新しい広告主が自社の業種でスケーリングを開始したときに次のテストを決して盲目的に選ばないようにする競合フィードです。まずTaboolaスパイツールでブラウザから競合コーパスを確認し、ワークフローが証明されたら同じクエリをプログラムで利用してください。