ボーナスクレジットキャンペーン向け Sponsored Jobs API 連携ガイド

Indeed 年間契約のボーナスクレジットを利用して、特別キャンペーンで求人をスポンサーします。

 

法的注意

Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。

概要

このガイドでは、Indeed 年間契約に基づくボーナススポンサー求人クレジットの利用に関する API サポートについて説明します。ボーナススポンサー求人クレジットを利用して、指定された特別キャンペーンで求人をスポンサーします。クレジットが広告主アカウントに割り当てられると、Indeed が対応するキャンペーンを自動的に作成します。

2026-01-19 以降、Sponsored Jobs API を使用して、ボーナスクレジット残高の確認、ボーナスクレジットキャンペーンの特定、求人ごとの予算のモニタリング、および求人選択クエリの更新を行えます。

変更点の概要

Sponsored Jobs API の変更点の概要

エンドポイント	変更タイプ	変更内容
クレジット割り当てと残高を取得 GET /v1/advertisers/credits	新規	広告主のボーナススポンサー求人クレジットの合計と残高を取得します。 以下をご覧ください。 クレジット残高の可視化（新規） 求人ごとの予算の可視化（更新）
雇用主のキャンペーンとステータスの一覧 GET /v1/campaigns	機能強化	新しい fields の値: FundingSource SponsorshipPlan DailyAvgBudgetPerJob ボーナスクレジットキャンペーンの識別（更新されたエンドポイント）をご覧ください。
キャンペーンの一般情報を取得 GET v1/campaigns/{campaignId}	機能強化	以下のフィールドを自動的に含みます。 FundingSource SponsorshipPlan 単一キャンペーンの詳細をご覧ください。
キャンペーンの予算と期間を取得 GET /v1/campaigns/{campaignId}/budget	機能強化	ボーナスクレジットキャンペーンの場合、以下のフィールドを自動的に含みます。 dailyAvgBudgetPerJob 求人ごとの予算の可視化（更新）をご覧ください。
キャンペーンの一般情報を更新 PATCH v1/campaigns/{campaignId}	機能強化	ボーナスクレジットキャンペーンに、求人選択条件を追加しました。 求人選択の更新をご覧ください。

クレジット残高の可視化（新規）

クレジット割り当てと残高を取得

エンドポイント	クレジット割り当てと残高を取得 GET /v1/advertisers/credits
説明	広告主のボーナススポンサー求人クレジットの合計と残高を取得します。 クレジット残高はリアルタイムで返されます。
認証	雇用主スコープによる OAuth 2.0
レスポンス	現在割り当て済みのクレジット合計 現在のクレジット残高 通貨
ユースケース	キャンペーンを計画する前に利用可能なクレジットを確認する クレジットの割り当てをモニタリングする 月を通じてクレジット利用状況を追跡する

ボーナスクレジットキャンペーンの識別（更新されたエンドポイント）

機能強化されたキャンペーン一覧

雇用主のキャンペーンとステータスの一覧

エンドポイント	雇用主のキャンペーンとステータスの一覧 GET /v1/campaigns
説明	キャンペーン一覧エンドポイントは、レスポンスに含めるデータを指定できる fields パラメータをすでにサポートしています。 追加された fields クエリパラメータの値: FundingSource SponsorshipPlan
認証	雇用主スコープによる OAuth 2.0
リクエスト	fields パラメータはカンマ区切りの値を受け付けます。キャンペーンの資金とプランの情報を取得するには、以下のいずれかまたは両方の fields の値を含めます。 FundingSource。ボーナスクレジットでキャンペーンが資金提供されているかどうかを示します。 SponsorshipPlan。プレミアムプランのキャンペーンを特定します。
レスポンス	FundingSource の値: ボーナスクレジットキャンペーンの場合は "Bonus Sponsored Job Credits"。 ボーナスクレジット以外のキャンペーンの場合は空文字列 ( "")。 SponsorshipPlan の値: UI で作成されたものを含む、ボーナスクレジットのプレミアムキャンペーンの場合は "Premium"。 ボーナスクレジット以外のキャンペーンおよび非プレミアムキャンペーンの場合は空文字列 ("")。

単一キャンペーンの詳細

キャンペーンの一般情報を取得

エンドポイント	キャンペーンの一般情報を取得 GET /v1/campaigns/{campaignId}
説明	機能強化されたキャンペーン一覧エンドポイントとは異なり、単一キャンペーンの詳細エンドポイントのレスポンスには、常に FundingSource と SponsorshipPlan の両方のフィールドが含まれます。
認証	雇用主スコープによる OAuth 2.0
リクエスト	fields パラメータはカンマ区切りの値を受け付けます。キャンペーンの資金とプランの情報を取得するには、以下のいずれかまたは両方の fields の値を含めます。 FundingSource。ボーナスクレジットでキャンペーンが資金提供されているかどうかを示します。 SponsorshipPlan。プレミアムプランのキャンペーンを特定します。
レスポンス	FundingSource の値（常に存在）。以下のいずれか: ボーナスクレジットキャンペーンの場合は "Bonus Sponsored Job Credits"。 ボーナスクレジット以外のキャンペーンの場合は空文字列 ( "")。 SponsorshipPlan の値（常に存在）。以下のいずれか: UI で作成されたものを含む、ボーナスクレジットのプレミアムキャンペーンの場合は "Premium"。 ボーナスクレジット以外のキャンペーンおよび非プレミアムキャンペーンの場合は空文字列 ("")。 null 値と空文字列 JSON レスポンスには以下の両方が含まれます。 FundingSource（空の場合） SponsorshipPlan（null または空の場合）

連携時の推奨事項

• 雇用主のキャンペーンとステータスの一覧クエリの場合:

  • ボーナスクレジットキャンペーンをフィルタまたは表示するには、必ず fields パラメータに FundingSource を含めてください。
  • ボーナスクレジットのプレミアムキャンペーンを特定するには、SponsorshipPlan を含めてください。
  • 完全に分類するには、両方の値を含めてください。

• キャンペーンの一般情報の取得では、両方のフィールドが常に存在します。特別な処理は不要です。

  • 通常のキャンペーンを特定するには、FundingSource の空文字列（""）を確認してください。
  • 標準プランのキャンペーンを特定するには、SponsorshipPlan の空文字列（""）を確認してください。

• ユースケース:

  • ボーナスクレジットキャンペーンを個別にフィルタして表示する。
  • ボーナスクレジットのプレミアムプランキャンペーンを特定する。

求人ごとの予算の可視化（更新）

• 更新されたエンドポイント:

  • GET /v1/campaigns（fields クエリパラメータでオプトイン）
  • GET /v1/campaigns/{campaignId}/budget（自動）

ボーナスクレジットキャンペーンは、Indeed が求人ごとに日次予算を推奨する日次予算モデルを使用します。従来のキャンペーンは、月またはキャンペーン期間の合計予算を使用します。

• 現在の状態: キャンペーンエンドポイントは BudgetOnetimeLimit（合計のライフタイム予算）または BudgetMonthlyLimit（月次予算）を返します。キャンペーンタイプに応じて、該当するフィールドのみが表示されます。

• 新規: DailyAvgBudgetPerJob フィールドは、ボーナスクレジットキャンペーンにおける求人ごとの平均日次予算を示します。

  Indeed の最適化システムが、求人選択に基づいて求人ごとの予算を自動的に管理します。この値は読み取り専用です。

機能強化されたキャンペーン一覧

エンドポイント	雇用主のキャンペーンとステータスの一覧 GET /v1/campaigns（fields クエリパラメータでオプトイン）
説明	このエンドポイントは、返されるデータを定義する fields クエリパラメータをすでにサポートしています。 新規: DailyAvgBudgetPerJob フィールドは、ボーナスクレジットキャンペーンにおける求人ごとの平均日次予算を示します。 フィールドが表示される場合: fields パラメータに dailyAvgBudgetPerJob を含めている。 キャンペーンがボーナスクレジットキャンペーン（またはその他の ADB キャンペーン）である。 キャンペーンに求人ごとの予算が設定されている。 フィールドが非表示の場合: キャンペーンが ADB キャンペーンではない（通常予算のキャンペーン）。 fields パラメータでフィールドがリクエストされていない。 主な動作: ボーナスクレジットキャンペーンの場合: DailyAvgBudgetPerJob のみを返します。 通常のキャンペーンの場合: BudgetOnetimeLimit または BudgetMonthlyLimit のみが表示されます（現在の動作）。 フィールドは条件付きです。関連があり、かつリクエストされた場合にのみ表示されます。
認証	雇用主スコープによる OAuth 2.0
リクエスト	fields パラメータはカンマ区切りの値を受け付けます。キャンペーンの資金とプランの情報を取得するには、以下のいずれかまたは両方の fields の値を含めます。 FundingSource。ボーナスクレジットでキャンペーンが資金提供されているかどうかを示します。 SponsorshipPlan。プレミアムプランのキャンペーンを特定します。
レスポンス	FundingSource の値（常に存在）。以下のいずれか: ボーナスクレジットキャンペーンの場合は "Bonus Sponsored Job Credits"。 ボーナスクレジット以外のキャンペーンの場合は空文字列 ("")。 SponsorshipPlan の値（常に存在）。以下のいずれか: UI で作成されたものを含む、ボーナスクレジットのプレミアムキャンペーンの場合は "Premium"。 ボーナスクレジット以外のキャンペーンおよび非プレミアムキャンペーンの場合は空文字列 ("")。 注記 null 値と空文字列 JSON レスポンスには以下の両方が含まれます。 FundingSource（空の場合） SponsorshipPlan（null または空の場合）

求人選択の更新

求人選択の更新

エンドポイント	キャンペーンの一般情報を更新 PATCH /v1/campaigns/{campaignId}
説明	ボーナスクレジットキャンペーンの求人選択を更新します。 ボーナスクレジットキャンペーンで許可される更新: jobsToInclude（ALL または QUERY ベース） jobsQuery
制限事項	Indeed がその他のキャンペーン設定（name、status、objective、budget）を管理します。これらの値を API で変更することはできません。
ユースケース	ボーナスクレジットキャンペーンに求人を追加または削除する。

連携ワークフロー

1. 前提条件

連携を開始する前に、以下を確認してください。

• Indeed とのアクティブな年間契約があること
• 雇用主スコープで設定された OAuth 2.0 クレデンシャル
• 米国を拠点とする広告主アカウント（初期リリースは米国のみ）
• 広告主アカウントに割り当てられたクレジット（Indeed カスタマーサービスチームが対応）

2. キャンペーン作成プロセス

備考

Indeed が最初にアカウントへボーナスクレジットを割り当てると、自動的にボーナスクレジットキャンペーンが作成されます。

1. Indeed がアカウントにボーナスクレジットキャンペーンを作成します。
2. キャンペーンは API ですぐに表示できるようになります。

3. クレジット残高をモニタリングする

• OAuth の Bearer トークンを使用して GET /v1/advertisers/{yourAdvertiserId}/credits を呼び出します。

  • ボーナスクレジットキャンペーンで求人をスポンサーする前。

  • クレジットが割り当てられたとき。

  • 支出追跡のために毎週または必要に応じて。

ベストプラクティス: 残高をキャッシュし、過度なポーリングを避けてください（呼び出しはレート制限の対象になります）。

4. ボーナスクレジットキャンペーンを特定する

• オプション A: 資金源を含めてすべてのキャンペーンを一覧表示する:

  • どのキャンペーンがボーナスクレジットで資金提供されているかを特定するには、GET /v1/campaigns を呼び出します。

    fields パラメータに FundingSource を含めてください。

  • ボーナスクレジットキャンペーンと通常予算キャンペーンを区別するには、FundingSource が "Bonus Sponsored Job Credits" と等しいかを確認します。

• オプション B: 特定キャンペーンの詳細を取得する:

  • GET /v1/campaigns/{campaignId} を呼び出します。

    この呼び出しはレスポンスに自動的に FundingSource フィールドを含めます。

5. 求人選択を更新する

• 求人選択条件を含む JSON 本文で PATCH /v1/campaigns/{creditCampaignId} を呼び出します。

  以下のフィールドを更新できます。

  • jobsToInclude。選択モード ( ALL または QUERY)。

  • jobsQuery。検索キーワード。

  以下のフィールドは更新できません。

  • キャンペーン名、ステータス、目的、予算（自動管理）、jobsTitle、jobsCompany、jobsLocation、jobsLocationRadius。

  エラー処理: 制限されたフィールドを更新すると、次のエラーが返されます。

  "Only Jobs Query Criteria field update is allowed for campaigns using Bonus Sponsored Job Credits."

6. 予算割り当てを確認する

• GET /v1/campaigns を呼び出します。特定のキャンペーンについては、 GET /v1/campaigns/{campaignId}/budget を呼び出します。

• いずれの呼び出しでも、fields パラメータに DailyAvgBudgetPerJob および FundingSource を含めるよう設定します。

  呼び出しは次の情報を返します。

  • キャンペーン全体の予算割り当て。

  • 求人ごとの平均日次予算（ボーナスクレジットキャンペーンの場合）。

 

このページは役に立ちましたか？