ボーナスクレジットキャンペーン向け Sponsored Jobs API 連携ガイド
Indeed 年間契約のボーナスクレジットを利用して、特別キャンペーンで求人をスポンサーします。
Indeed の API の使用について Indeed と書面による契約を締結していない場合、この API またはそのドキュメントを使用することにより、Indeed の API の使用には Indeed API Terms および Additional API Terms and Guidelines が適用されることに同意したものとみなされます。
連携の概要
Indeed 年間契約のボーナススポンサー求人クレジットを利用して、指定されたキャンペーンで求人をスポンサーします。Indeed が広告主アカウントにクレジットを追加すると、Indeed がキャンペーンを作成します。
2026-01-19 以降、Sponsored Jobs API を使用して、ボーナスクレジット残高の確認、ボーナスクレジットキャンペーンの特定、求人ごとの予算のモニタリング、および求人選択クエリの更新を行えます。
変更点の概要
| エンドポイント | 変更タイプ | 変更内容 |
|---|---|---|
クレジット割り当てと残高を取得 | 新規 | 広告主のボーナススポンサー求人クレジットの合計と残高を取得します。 |
採用企業のキャンペーンとステータスの一覧 | 機能強化 | 新しい
|
キャンペーンの一般情報を取得 | 機能強化 | 以下のフィールドを自動的に含みます。
|
キャンペーンの 予算と期間を取得 | 機能強化 | ボーナスクレジットキャンペーンの場合、 |
キャンペーンの一般情報を更新 | 機能強化 | ボーナスクレジットキャンペーンに求人選択条件を追加します。 |
連携時の推奨事項
-
採用企業のキャンペーンとステータスの一覧クエリの場合:
- ボーナスクレジットキャンペーンをフィルタまたは表示するには、
fieldsにFundingSourceを含めます。 - ボーナスクレジットのプレミアムキャンペーンを特定するには、
SponsorshipPlanを含めます。 - 完全に分類するには、両方を含めます。
- ボーナスクレジットキャンペーンをフィルタまたは表示するには、
-
キャンペーンの一般情報の取得では、両方のフィールドが常に存在するため、特別な処理は不要です。
FundingSourceが空文字列（""）の場合は、通常のキャンペーンです。SponsorshipPlanが空文字列（""）の場合は、標準ティアのキャンペーンです。
-
ユースケース:
- ボーナスクレジットキャンペーンを個別にフィルタして表示する。
- ボーナスクレジットのプレミアムティアのキャンペーンを特定する。
連携手順
1. 前提条件
連携する前に、以下があることを確認してください。
- Indeed とのアクティブな年間契約
- 採用企業スコープを持つ OAuth 2.0 クレデンシャル
- 米国を拠点とする広告主アカウント（初期リリースは米国のみ）
- Indeed カスタマーサービスチームが広告主アカウントに割り当てたクレジット
2. キャンペーン予算見積もりを取得する
採用企業が平均日次予 算（ADB）キャンペーンを作成する前に、このエンドポイントを使用して、各求人の推奨日次予算とキャンペーンレベルの平均日次予算を取得します。
| メソッド | エンドポイント | リファレンス |
|---|---|---|
POST |
| Get campaign budget quote |
レスポンスには、スポンサーシッププランの平均予算見積もり、一致した各求人の見積もり、および STANDARD ティアと PREMIUM ティアの推奨事項が含まれます。
推奨日次予算は目標であり、保証ではありません。Indeed はこの目標に向けて最適化しますが、日次の支出は変動します。たとえば、平均日次予算が 25 ドルの場合、1 日目の支出が 20 ドル、2 日目が 30 ドルになることがあります。
このエンドポイントの呼び出しは、Sponsored Jobs API の利用ポリシーに基づく課金の対象になりません。
- 新しい求人を掲載してから 2〜3 時間待ってキャンペーンを作成します。
- 予算推奨の呼び出しから 1 時間以内にキャンペーンを作成します。それ以降は市場状況が変化する可能性があり、キャンペーンの作成には最新の推奨予算が使用されます。
- 手動で追加 された求人、およびクエリベースの求人解決によって自動的に追加された求人は、推奨予算をデフォルトの日次支出として使用します。
リクエスト:
curl -L -X POST 'https://apis.indeed.com/ads/v1/campaignbudgetquote' \-H 'Content-Type: application/json' \-H 'Accept: application/json' \--data-raw '{ "jobsQuery": "title:\"financial analyst\" AND city:(toronto OR \"new york\")", "jobsTitle": "Healthcare Intern", "jobsCompany": "Indeed", "jobsLocation": "Austin, TX", "jobsLocationRadius": 25, "jobsSourceId": "8977ac341a3c4527", "jobsSourceName": "CompanyABC", "jobsToInclude": "ALL"}'レスポンス:
{ "meta": { "status": 200, "errors": [{ "type": "RESOURCE_NOT_FOUND", "description": "Couldn't locate the requested resource" }], "rootLocation": "https://apis.indeed.com/ads", "perPage": 25, "links": [{ "rel": "next", "href": "/v1/campaigns/3141592653589793" }] }, "data": { "sponsorshipPlanBudgetQuotes": [{ "sponsorshipPlan": "PREMIUM", "dailyAvgBudgetPerJob": { "amount": 1500, "currency": "USD" }, "jobBudgetQuotes": [{ "jobKey": "89deb9de58ebe149", "dailyBudget": { "amount": 1500, "currency": "USD" } }] }] }}3. キャンペーン作成プロセス
Indeed が最初にアカウントへボーナスクレジットを割り当てると、Indeed がボーナスクレジットキャンペーンを作成します。
Indeed がアカウントにボーナスクレジットキャンペーンを作成し、そのキャンペーンは API からすぐに確認できます。
4. クレジット残高をモニタリングする
OAuth の Bearer トークンを使用して GET /v1/advertisers/credits を呼び出します。
- ボーナスクレジットキャンペーンで求人をスポンサーする前。
- Indeed がクレジットを割り当てたとき。
- 支出を追跡するために毎週、または必要に応じて。
ベストプラクティス: 頻繁にポーリングする代わりに、残高をキャッシュしてください。呼び出しはレート制限の対象になります。
5. ボーナスクレジットキャンペーンを特定する
次の 2 つのオプションがあります。
-
採用企業のキャンペーンとステータスの一覧 —
GET /v1/campaignsを呼び出し、fieldsにFundingSourceを含めます。FundingSourceが"Bonus Sponsored Job Credits"の場合、そのキャンペーンはボーナスクレジットで資金提供されています。 -
キャンペーンの一般情報を取得 —
GET /v1/campaigns/:campaignIdを呼び出します。このレスポンスには、常に
FundingSourceが含まれます。
6. 求人選択を更新する
求人選択条件を含む JSON 本文で PATCH /v1/campaigns/:campaignId を呼び出します。
次のフィールドを更新できます。
jobsToInclude。選択モードで、ALLまたはQUERYです。jobsQuery。検索キーワードです。
キャンペーン名、ステータス、目的、予算は Indeed が管理するため、更新できません。jobsTitle、jobsCompany、jobsLocation、jobsLocationRadius も 更新できません。
制限されたフィールドを更新すると、次のエラーが返されます。
"Only Jobs Query Criteria field update is allowed for campaigns using Bonus Sponsored Job Credits."7. 予算割り当てを確認する
すべてのキャンペーンについては、GET /v1/campaigns を呼び出し、fields に DailyAvgBudgetPerJob と FundingSource を含め ます。
1 つのキャンペーンについては、GET /v1/campaigns/:campaignId/budget を呼び出します。このエンドポイントは、ボーナスクレジットキャンペーンの場合に DailyAvgBudgetPerJob を自動的に返します。
いずれの呼び出しでも、キャンペーン全体の予算割り当てと、ボーナスクレジットキャンペーンの場合は求人ごとの平均日次予算が返されます。