スポンサー求人APIの呼び出し回数を削減するベストプラクティス

スポンサー求人APIの呼び出し回数を削減するためのベストプラクティスです。

 

法的注意

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

• 2026年1月8日:

  • 2026年2月1日より、Indeed は EU 諸国およびスイスのすべてのユーザーに対して、Indeed Sponsored Jobs API の使用ポリシーを適用します。対象国は、AT、BE、CH、DE、DK、EE、ES、FI、FR、GR、IE、IT、LU、NL、PL、PT、RO、および SE です。

    Indeed は、Sponsored Jobs API の呼び出し 1 回ごとに 3 EUR、または広告主が選択した請求通貨での同等額を請求します。Indeed は、月間のキャンペーンスポンサーシップ支出額が月間の API 呼び出し総費用を下回る場合にのみ課金します。

  • 2026年2月1日より、Indeed は AR、AU、BR、CA、CL、CO、CR、GB、ID、IN、MX、MY、NZ、PA、PH、SG、および TH のすべてのユーザーに対して、Indeed Sponsored Jobs API の使用ポリシーを適用します。

    Indeed は、Sponsored Jobs API の呼び出し 1 回ごとに 3 USD、または広告主が選択した請求通貨での同等額を請求します。Indeed は、月間のキャンペーンスポンサーシップ支出額が月間の API 呼び出し総費用を下回る場合にのみ課金します。

    このポリシーでは、Sponsored Jobs API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。

    推奨される使用パターンについては、Sponsored Jobs API best practices to reduce call volume （新しいウィンドウで開きます） をご覧ください。

    Sponsored Jobs API を使用できるのは、過去 3 暦月以内にキャンペーンを通じてスポンサー求人を掲載した有料のお客様のみです。

    Indeed は、暦月ごとの Sponsored Jobs API の使用回数に上限を設けています。この上限は、前月の Sponsored Jobs キャンペーン支出額とクレジット上限額のいずれか大きい方に等しくなります。

    /apiquotausage エンドポイントを呼び出して、当月の API 使用状況を取得します。

• 2026年1月8日:

  • 2024年12月1日より、Indeed は米国において Indeed Sponsored Jobs API の使用ポリシーを適用します。

    このポリシーでは、Indeed Sponsored Jobs API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。

    このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。

    推奨される API 使用パターンについては、Sponsored Jobs API best practices to reduce call volume （新しいウィンドウで開きます） をご覧ください。

• 2024-06-30 より有効：GET /v1/stats/datastatus エンドポイントは廃止され、HTTP 404 を返します。代わりに GET /v1/stats を使用してください。

• 2024-06-26 より有効：GET /v1/campaigns/:campaignId/stats/:date および GET /v1/campaigns/:campaignId/stats/entryDates エンドポイントは廃止され、HTTP 404 を返します。

  代わりに GET /v1/campaigns/{campaignId}/stats を使用してください。

• 2024-06-26 より有効：GET /v1/campaigns の perPage パラメータは 500 が上限となります。これより大きい値を指定したリクエストは、無効として拒否されます。

スポンサー求人APIの呼び出し回数を削減するには、次のベストプラクティスに従ってください。

ベストプラクティス

スポンサー求人APIの呼び出し回数を削減するベストプラクティス

ベストプラクティス
✅	優先度が高いキャンペーンは呼び出し頻度を上げ、優先度が低いキャンペーンは呼び出し頻度を下げてください。
✅	アクティブなキャンペーンに対してのみAPIを呼び出してください。 90日より前に作成または最終更新されたキャンペーンはスキップしてください。一部の連携では、これまでに作成したすべてのキャンペーンに対してスポンサー求人APIを呼び出しています。 アクティブなキャンペーンへのリクエストは、妥当な頻度でスロットリングしてください。
✅	詳細な求人レベルのレポートは、1日に1回だけリクエストしてください。 その日の残り時間は同じレポートIDを再利用してください。APIは同じレポートIDに対して、利用可能になった更新データを返すため、その日に新しいIDを生成する必要はありません。
✅	求人の有効期限が切れた場合や、クライアントが Indeed での支出を停止した場合は、statusをDELETEDに設定してください。
✅	現実的なページサイズを使用してください。キャンペーン一覧は500未満にしてください。 perPageは妥当な値に設定し、最大整数値は指定しないでください。
✅	リクエストは均等に分散し、大きなトラフィックバーストを送らないでください。
✅	エラーを防ぐため、どのAPIを呼び出す場合も必須フィールドをすべて指定してください。
✅	APIは必要なときだけ呼び出してください。変更がない場合、繰り返し呼び出しても同じレスポンスが返ります。
✅	複数の社内チームが同じAPIデータを必要とする場合は、1つのチームがAPIを呼び出し、結果を社内共有してください。各チームが個別に呼び出すことは避けてください。
✅	同じデータに対する繰り返しリクエストを減らすため、レスポンスをローカルにキャッシュしてください。
✅	適用可能な場合は、日付ベースのフィルターを使って新規または更新されたレコードのみ取得してください。
❌	静的情報を取得するための高頻度呼び出しは避けてください。 採用企業情報を取得するGET /v1/account 採用企業のキャンペーンを一覧表示するGET /v1/campaigns キャンペーン予算情報を取得するGET /v1/campaigns/:campaignId/budget

API呼び出し

API呼び出し別の具体的な推奨事項は、次のトピックを確認してください。

• APIクォータ使用量
• APIアクセス
• アカウント管理
• キャンペーン管理
• レポート
• キャンペーン予測
• データ取得

APIクォータ使用量

APIクォータ使用量

エンドポイント	推奨される利用パターン
広告主のAPIクォータ使用量を取得する GET /v1/apiquotausage	指定月の広告主のスポンサー求人API使用量、クォータ、スポンサー求人支出を取得します。月を指定しない場合は当月を使用します。 指定月のAPI使用回数（日次更新）、割り当て済みクォータ、スポンサー求人支出を返します。クォータは月次で設定される静的データのため、頻繁な呼び出しは避けてください。 クォータ超過や、API利用コストが月間スポンサー求人支出を上回ることによる追加料金を防ぐため、現在の使用量と支出の監視に使用してください。 当月および過去6か月のクォータ使用量と支出の取得に使用してください。

APIアクセス

APIアクセス

エンドポイント	推奨される利用パターン
広告主のAPIアクセスを更新する PATCH /v1/account/apiaccess	広告主のAPIアクセスをブロックまたは有効化します。 スポンサー求人APIの使用ポリシーによってアクセスがブロックされた場合の更新に使用します。 apiAccessStatusをACTIVEまたはBLOCKEDに設定してください。 このエンドポイントでアクセスを有効化した広告主には、この使用ポリシーが適用されます。 このエンドポイントを呼び出す主なケース: 呼び出し上限に達してスポンサー求人APIを呼び出せない広告主のアクセスを再有効化する場合。 特定の広告主またはアカウントとの連携を終了し、スポンサー求人APIへのアクセスをブロックする場合。 広告主のAPIクォータ使用量の取得方法は「広告主のAPIクォータ使用量を取得する」をご覧ください。

アカウント管理

アカウント管理

エンドポイント	推奨される利用パターン
採用企業の Indeed 広告主アカウント情報を取得する GET /v1/account	採用企業アカウントの静的情報を返します。請求ステータスと通貨コードの確認に使用してください。 アカウント設定後は、アカウント更新があった場合を除き呼び出さないでください。
広告主サブアカウントを一覧表示する GET /v1/subaccounts	サブアカウント情報は、アカウント作成または更新時にのみ更新されます。アカウントに変更があったときだけ呼び出してください。 変更がない状態で呼び出しても同じレスポンスが返ります。

キャンペーン管理

キャンペーン管理

エンドポイント	推奨される利用パターン
採用企業キャンペーンとステータスを一覧表示する GET /v1/campaigns	通常、キャンペーン作成にはお客様が所有またはライセンスしたソフトウェアを使用するため、この情報は手元にある状態が理想です。 採用企業レベルでの呼び出しは低頻度にしてください。
キャンペーンを作成する POST /v1/campaigns キャンペーンを作成します。	採用企業からのスポンサー開始リクエストに応じて、必要なときに呼び出してください。
キャンペーンの基本情報を取得する GET /v1/campaigns/:campaignId	キャンペーン情報を保存し、必要に応じて定期的に呼び出して更新してください。データのほとんどは静的です。 支出中のキャンペーンのみに対して呼び出してください。これまで作成したすべてのキャンペーンを対象に呼び出さないでください。
キャンペーンの基本情報を更新する PATCH /v1/campaigns/:campaignId	ユーザー操作によるキャンペーン一時停止またはキャンペーン名変更時のみ呼び出してください。 キャンペーンレベルでの呼び出しは低頻度にしてください。
キャンペーンの予算と期間を取得する GET /v1/campaigns/:campaignId/budget	このAPIはユーザー定義の静的値を返します。 キャンペーンレベルでの呼び出しは低頻度にしてください。
キャンペーンの予算と期間を更新する PATCH /v1/campaigns/:campaignId/budget	キャンペーン予算や開始日・終了日の頻繁な変更は、API最適化に影響します。 ユーザー操作に基づく場合のみ呼び出してください。 キャンペーンレベルでの呼び出しは低頻度にしてください。
キャンペーンの求人数を取得する GET /v1/campaigns/:campaignId/jobCount	複数求人キャンペーンに対してのみ呼び出してください。 キャンペーンの求人マッピングに変更がない限り結果は同じため、複数回呼び出さないでください。
キャンペーン内求人の詳細を取得する GET /v1/campaigns/:campaignId/jobDetails	複数求人キャンペーンに対してのみ呼び出してください。 キャンペーンの求人マッピングに変更がない限り結果は同じため、複数回呼び出さないでください。
採用企業のキャンペーンの主要な日付を取得する GET /v1/campaigns/:campaignId/properties	ATSの採用企業にとっては有用性が高くありません。このデータが利用可能でも、発生した問題を解決する手段がないためです。 このAPIは呼び出さないでください。

レポート

レポート

エンドポイント	推奨される利用パターン
期間を指定してキャンペーンの統計を取得する GET /v1/campaigns/:campaignId/stats	指定した期間のキャンペーンの統計を取得します。 ユーザーの社内ダッシュボード用途ではリアルタイムに利用してください。
期間を指定してキャンペーン別・求人別のトラフィックレポートを取得する GET /v1/stats	詳細レポートへのリンクを取得します。詳細な求人レベルレポートは1日1回のみリクエストできますが、レポートIDは再利用できます。同じIDを使うと、APIは利用可能になった更新データを返します。すでにその日のIDがある場合は新規生成が不要なため、呼び出し回数を削減できます。
広告主のAPIクォータ使用量を取得する GET /ads/v1/apiquotausage	特定月の広告主のスポンサー求人API使用量、クォータ、スポンサー求人支出を取得します。

キャンペーン予測

キャンペーン予測

エンドポイント	推奨される利用パターン
キャンペーン予測を取得する POST /v1/campaignpredictions	このAPIを連携済みの場合は、採用企業がキャンペーン予算について適切に判断できるよう活用してください。 このAPIは低利用エンドポイントです。必要性を見極めて呼び出してください。
オーガニック求人のパフォーマンスと予測を取得する POST /v1/organicjobprediction	このAPIを連携済みの場合は、採用企業がスポンサーシップの利点を判断できるよう活用してください。 このAPIは低利用エンドポイントです。採用企業が「Indeed でこの求人をスポンサーすべきか」を判断するワークフロー内でのみ、適切に呼び出してください。 そのワークフローがない場合は呼び出さないでください。

データ取得

スポンサー求人APIが取得するデータは、毎日、日次更新のタイミングで1回更新されます。

当日分のキャンペーン実績データや支出データを取得しようとしてスポンサー求人APIを呼び出すと、エラーや不正確な数値が表示される場合があります。

たとえば、ユーザーが2026-01-31にスポンサー求人APIを呼び出した場合、APIが取得する対象期間は2026-01-01から2026-01-30までです。

2026-01-01から2026-01-31までの最も正確なデータを取得するには、2026-02-01まで待ってからAPIを呼び出してください。

 

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