呼び出し回数を減らすためのSponsored Jobs APIのベストプラクティス

Sponsored Jobs 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 が上限となります。これより大きい値を指定したリクエストは、無効として拒否されます。

Sponsored Jobs APIの呼び出し回数を減らすには、次のベストプラクティスに従ってください。

ベストプラクティス

Sponsored Jobs APIの呼び出し回数を減らすためのベストプラクティス

ベストプラクティス
✅	優先度の高い求人を含むキャンペーンではAPIをより頻繁に呼び出し、優先度の低い求人を含むキャンペーンでは呼び出し頻度を下げます。
✅	アクティブなキャンペーンに対してのみ、APIを呼び出します。 作成または最終更新から90日以上経過したキャンペーンに対しては、APIを呼び出さないでください。 一部のAPI呼び出し元では、連携の運用期間中に作成したすべてのキャンペーンに対して、Sponsored Jobs APIを頻繁に呼び出しています。 アクティブなキャンペーンへのリクエストは、適切な頻度に制限してください。
✅	詳細な求人レベルのレポートは、1日に1回のみリクエストしてください。 その日のレポートIDをすでに取得している場合は、再利用できます。同じレポートIDを使用すると、APIは利用可能になり次第、更新されたデータを返します。これにより、その日のレポートIDをすでに取得している場合は新たに生成する必要がなくなるため、呼び出し回数を削減できます。
✅	求人の有効期限が切れた場合や、クライアントがIndeedでの支出を停止した場合は、statusをDELETEDに設定してください。
✅	ページサイズには、現実的な数値を適切に指定してください。キャンペーンのリストは500未満である必要があります。 一部のAPI呼び出し元では、ページサイズパラメーターをサポートするAPIを最大整数値で呼び出しています。ページサイズには、適切な数値を使用することをおすすめします。 perPageパラメーターを含むAPIでは、その値を適切なサイズに設定してください。
✅	リクエストの間隔は均等に空け、大量のトラフィックを同時に送信することは避けてください。
✅	エラーを回避するため、APIを呼び出す際にはすべての必須情報が指定されていることを確認してください。
✅	APIは必要な場合にのみ呼び出してください。変更が想定されないにもかかわらず繰り返し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	広告主の指定月におけるSponsored Jobs APIの使用量、クォータ、スポンサー求人支出を取得します。指定しない場合は、当月がデフォルトとして使用されます。 日次で更新される指定月のAPI使用回数、割り当てられたAPIクォータ、スポンサー求人への支出に関する情報を返します。クォータデータは月次で設定される静的な値のため、頻繁な呼び出しは避けてください。 クォータの超過を回避し、API使用料金が月間のスポンサー求人支出を超える場合の追加料金を抑えるため、このAPIを呼び出して現在の使用量と支出を監視してください。 過去のクォータ使用量と支出データを取得するために、このAPIを呼び出します。

APIアクセス

APIアクセス

エンドポイント

推奨される使用パターン

広告主のAPIアクセスを更新する PATCH /v1/account/apiaccess

広告主のAPIへのアクセスをブロックまたは有効化します。 Sponsored Jobs APIの使用ポリシーによってブロックされている場合に、APIアクセスを更新できるようにします。 APIアクセスステータス（apiAccessStatus）を、ACTIVEまたはBLOCKEDのいずれかに設定します。 このエンドポイントを呼び出してアクセスを有効化したすべての広告主は、この使用ポリシーの対象となります。 このエンドポイントを呼び出すケースの例： 広告主が呼び出し制限に達したためにSponsored Jobs APIを呼び出せない場合は、このAPIを呼び出してアクセスを再度有効化します。 特定の広告主やアカウントとの取引を継続しない場合は、Sponsored Jobs APIへのアクセスをブロックします。 広告主のAPIクォータ使用量を取得する方法については、広告主のAPIクォータ使用量を取得するをご覧ください。

アカウント管理

アカウント管理

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

キャンペーン管理

キャンペーン管理

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

レポート

レポート

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

キャンペーン予測

キャンペーン予測

エンドポイント	推奨される使用パターン
キャンペーン予測を取得する POST /v1/campaignpredictions	このAPIと連携している場合は、雇用主がキャンペーン予算について十分な情報に基づく意思決定を行えるよう、活用してください。 このAPIは、使用頻度の低いエンドポイントです。適切な頻度で呼び出してください。
オーガニック求人のパフォーマンスと予測を取得する POST /v1/organicjobprediction	このAPIと連携している場合は、雇用主がスポンサーシップのメリットについて十分な情報に基づく意思決定を行えるよう、活用してください。 このAPIは、使用頻度の低いエンドポイントです。雇用主がIndeedで該当の求人をスポンサーすべきか判断するスポンサーシップのワークフローで、適切な頻度で呼び出してください。 このワークフローが利用できない場合は、このAPIを呼び出さないでください。

データ取得

Sponsored Jobs APIで取得されるデータは、1日の終わりに1回更新されます。

当日のキャンペーンパフォーマンスデータや支出データを取得するためにSponsored Jobs APIを呼び出すと、エラーが発生したり、不正確な数値が返されたりする場合があります。

例えば、ユーザーが2026年1月31日にSponsored Jobs APIを呼び出した場合、APIは2026年1月1日から2026年1月30日までのデータを取得します。

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

 

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