前提条件
OAuthを設定する
OAuth v2トークンスコープ
OAuthアクセストークンを取得する
キャンペーン管理ガイド
キャンペーン予算見積もりを取得する
単発キャンペーンを作成する
目標ベースのキャンペーンを作成する
定期キャンペーンを作成する
定期キャンペーン情報を更新する
キャンペーン予算を更新する
キャンペーン期間を更新する
キャンペーン内の求人の詳細を取得する
レポートのハウツーガイド
キャンペーンパフォーマンスをレポートする
アカウント管理のハウツーガイド
採用企業アカウント情報を取得する
サブアカウント情報を取得する
サブアカウントを作成する
アカウント予算を取得する
アカウント予算を設定する
APIクォータ使用量のハウツーガイド
広告主のAPIクォータ使用量を取得する
推奨事項とガイドライン
結果整合性に備える
API変更との互換性を確保する
FAQとトラブルシューティング
FAQ
よくあるエラーをトラブルシューティングする
OAuthエラーをトラブルシューティングする

スポンサー求人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 スポンサー求人API の使用ポリシーを適用します。対象国は、AT、BE、CH、DE、DK、EE、ES、FI、FR、GR、IE、IT、LU、NL、PL、PT、RO、および SE です。
  Indeed は、スポンサー求人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 スポンサー求人API の使用ポリシーを適用します。
  Indeed は、スポンサー求人API の呼び出し 1 回ごとに 3 USD、または広告主が選択した請求通貨での同等額を請求します。Indeed は、月間のキャンペーンスポンサーシップ支出額が月間の API 呼び出し総費用を下回る場合にのみ課金します。
  このポリシーでは、スポンサー求人API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。
  推奨される使用パターンについては、スポンサー求人API best practices to reduce call volume （新しいウィンドウで開きます）をご覧ください。
  スポンサー求人API を使用できるのは、過去 3 暦月以内にキャンペーンを通じてスポンサー求人を掲載した有料のお客様のみです。
  Indeed は、暦月ごとのスポンサー求人API の使用回数に上限を設けています。この上限は、前月の Sponsored Jobs キャンペーン支出額とクレジット上限額のいずれか大きい方に等しくなります。
  /apiquotausage エンドポイントを呼び出して、当月の API 使用状況を取得します。
2026年1月8日:
- 2024年12月1日より、Indeed は米国において Indeed スポンサー求人API の使用ポリシーを適用します。
  このポリシーでは、Indeed スポンサー求人API のお客様に対して、スポンサーシップ支出額に基づく API 使用料の支払いを求めます。
  このポリシーは、Indeed 独自の ATS プラグインを使用するお客様には適用されません。
  推奨される API 使用パターンについては、スポンサー求人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 の廃止：
- 2021-08-01：Indeed OAuth v2 エンドポイントを使用し、可用性が高く低レイテンシのインフラストラクチャで動作する、最新のスポンサー求人API ゲートウェイへ移行してください。
- 2022-01-01：Sponsored Jobs レガシー API が廃止されました。
- 2022-03-31：Sponsored Jobs XML 連携が廃止されました。

前提条件、例付きのハウツーガイド、FAQ、トラブルシューティングをご覧ください。

前提条件

OAuthを設定する

スポンサー求人APIを使用する前に、次のものが必要です。

Indeedアカウント
APIクライアントIDとシークレット
Indeedアカウント内でスポンサーできる求人
アカウントに関連付けられた採用企業

スポンサー求人APIのOAuth
OAuth	説明
2-legged OAuth	このガイドの例では、クライアントクレデンシャルフロー（2-legged OAuth）を使用します。直接採用企業、代理店、またはプログラマティックパートナーの場合は、このフローを使用してください。採用企業に代わって業務を行う代理店またはプログラマティックパートナーの場合、Indeedは、採用企業がお客様のIndeedアカウントをセカンダリユーザー（新しいウィンドウで開きます）として追加することを推奨します。これにより、クライアントクレデンシャルフローを使用できます。クライアントIDとシークレットを取得するには、Partner Console （新しいウィンドウで開きます）で2-legged OAuthアプリを登録します。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
3-legged OAuth	ATSパートナーは認可コードフロー（3-legged OAuth）を使用する必要があります。 Indeed パートナーになると、Indeed が連携用のアプリを作成します。Partner Console （新しいウィンドウで開きます）にサインインすると、アプリと OAuth 認証情報（クライアント ID とシークレット）を確認できます。API 呼び出しを認証するには、これらの認証情報をアクセストークンと交換します。

OAuth v2トークンスコープ

アクセストークンを取得するときは、少なくとも 1 つのスコープをリクエストする必要があります。

書き込みスコープには、対応する読み取り専用スコープが含まれます。たとえば、employer.advertising.campaign には employer.advertising.campaign.read も含まれます。
1 つのアクセストークンに複数のスコープをリクエストできます。用語集をご覧ください。スコープはスペースで区切って指定します。例: employer_access employer.advertising.campaign employer.advertising.campaign_report.read

OAuth 認可コードリクエストでは、呼び出す API エンドポイントに必要なスコープを含めます。エンドユーザーは、そのスコープの一部、すべて、またはどれも付与しないことができます。用語集をご覧ください。

次をご覧ください。

OAuthアクセストークンを取得する

oauth/v2/tokensを呼び出してアクセストークンを取得するには、使用するAPI向けのトークンをリクエストします。

スポンサー求人APIのほとんどのエンドポイントは、採用企業を表すアクセストークンを必要とします。呼び出す予定のエンドポイントで必要なスコープに加えてemployer_accessをリクエストし、データにアクセスする採用企業を指定するemployerパラメータを含めてください。

マスターアカウントを使用してサブアカウント管理エンドポイントを呼び出す場合は、アクセストークンをリクエストする際にemployerパラメータを省略してください。

サブアカウント管理エンドポイントは、次のいずれかで呼び出せます。

GET /v1/subaccounts
POST /v1/subaccounts

tokensエンドポイントのAPI詳細

tokensエンドポイント
API URL	`https://apis.indeed.com/oauth/v2/tokens`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	なし

tokensエンドポイントのリクエストパラメータ

tokensリクエストパラメータ
キー	値
`client_id`	クライアントID。次から取得します。日本のみ: アプリ認証情報の管理（新しいウィンドウで開きます）。詳細については、認証情報をご覧ください。日本以外: Partner Console （新しいウィンドウで開きます）。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
`client_secret`	クライアントシークレット。次から取得します。日本のみ: アプリ認証情報の管理（新しいウィンドウで開きます）。詳細については、認証情報をご覧ください。日本以外: Partner Console （新しいウィンドウで開きます）。コンソールにアクセスできない場合は、Indeed担当者または marketplacesupport@indeed.com にお問い合わせください。
`grant_type`	`client_credentials`
`scope`	呼び出すエンドポイントによって異なります。例: `employer_access employer.advertising.account.read`。
`employer`	採用企業アカウントID。

tokensエンドポイントのレスポンス例

{
  "access_token": "<access_token>",
  "scope": "employer.advertising.account.read employer_access",
  "token_type": "Bearer",
  "expires_in": 3600
}

キャンペーン管理ガイド

キャンペーン予算見積もりを取得する

採用企業は、平均日次予算（ADB）キャンペーンを作成する前に、求人ごとの推奨日次予算とキャンペーンレベルの平均日次予算を取得できます。

スポンサーシッププランの平均予算見積もり、一致した各求人の予算見積もり、およびSTANDARDティアとPREMIUMティアの推奨値を返します。

推奨日次予算は目標であり、保証ではありません。Indeedは目標に向けて最適化しますが、実際の日次支出は変動する場合があります。

たとえば、平均日次予算が$25の場合、1日目の支出が$20、2日目の支出が$30になることがあります。

このエンドポイントへの呼び出しは、スポンサー求人APIの使用ポリシーでは課金対象になりません。

新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
予算推奨の呼び出しから1時間以内にキャンペーンを作成してください。それを過ぎると市場環境が変わる可能性があり、キャンペーンの作成には最新の推奨予算が使用されます。
クエリベースの求人解決によって自動的に追加された求人は、キャンペーン作成後に追加された場合も、推奨予算が日次支出の既定値として使用されます。
キャンペーンに手動で追加された求人も、推奨予算が日次支出の既定値として使用されます。

この例では、求人ごとの推奨日次予算とキャンペーンレベルの平均日次予算を取得します。

求人ごとの推奨日次予算とキャンペーンレベルの平均日次予算を取得します。

API詳細:

キャンペーン予算見積もりを取得する
API URL	`https://apis.indeed.com/ads/v1/campaignbudgetquote`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

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": 0,
           "currency": "string"
         },
         "jobBudgetQuotes": [
           {
             "jobKey": "89deb9de58ebe149",
             "dailyBudget": {
               "amount": 0,
               "currency": "string"
             }
           }
         ]
       }
     ]
   }
}

単発キャンペーンを作成する

前提条件

新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
キャンペーンを作成する前に、採用企業アカウントを求人ソースに関連付ける必要があります。アカウントの求人ソースを一覧表示するには、GET /v1/accountを使用します。関連付けられている求人ソースがない場合は、Indeedカスタマーサポートにお問い合わせください。
キャンペーンが求人をスポンサーする前に、採用企業アカウントに有効な請求情報が登録されている必要があります。

この例では、2週間実行される単発キャンペーンを作成し、$500の予算で2か所の求人をスポンサーします。

必要なスコープを持つアクセストークンを使用します。

単発キャンペーンを作成する
scope employer_access employer.advertising.campaign
求人ソースIDを取得します。

求人ソースIDを確認するには、採用企業アカウント情報を取得する手順をご覧ください。採用企業は、Webサイトやドメインごとにそれぞれ1つずつ、複数の求人ソースIDを持つことができます。対象のサイトのjobSourceList.idを使用してください。

単発キャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

単発キャンペーンを作成します。

API詳細:

単発キャンペーンのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/campaigns`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "name": "Test Campaign Single-use",
  "status": "PAUSED",
  "trackingToken": "MyTrackingToken",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "QUERY",
  "jobsQuery": "city:Aberdeen OR city:Glasgow",
  "budgetOnetimeLimit": 500,
  "startDate": "2021-09-01",
  "fixedEndDate": "2021-09-15"
}

レスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/c8bxxxxxxxxx449"
    }]
  },
  "data": {
    "campaignId": "c8bxxxxxxxxx449"
  }
}

Indeedでキャンペーンを表示します。

API呼び出し:

キャンペーンを作成するAPI呼び出し

Indeedで作成されたキャンペーン:

Indeedで作成された単発キャンペーン

目標ベースのキャンペーンを作成する

前提条件

新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
キャンペーンを作成する前に、採用企業アカウントを求人ソースに関連付ける必要があります。アカウントの求人ソースを一覧表示するには、GET /v1/accountを使用します。関連付けられている求人ソースがない場合は、Indeedカスタマーサポートにお問い合わせください。
キャンペーンが求人をスポンサーする前に、採用企業アカウントに有効な請求情報が登録されている必要があります。

この例では、特定の予定面接数を目標とする目標ベースのキャンペーンを作成します。

平均日次予算（ADB）キャンペーンでは、目標を設定または変更できません。その他のスポンサー求人APIキャンペーンには、すべて目標が必要です。

必要なスコープを持つアクセストークンを使用します。

目標ベースのキャンペーンを作成する
scope employer_access employer.advertising.campaign
求人ソースIDを取得します。

求人ソースIDを確認するには、採用企業アカウント情報を取得する手順をご覧ください。採用企業は、Webサイトやドメインごとにそれぞれ1つずつ、複数の求人ソースIDを持つことができます。対象のサイトのjobSourceList.idを使用してください。

目標ベースのキャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

面接目標キャンペーンを作成します。

API詳細:

面接目標キャンペーンを作成する
API URL	`https://apis.indeed.com/ads/v1/campaigns`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "name": "XXX SCHEDULED_INTERVIEWS",
  "status": "PAUSED",
  "trackingToken": "indeed_chi",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "ALL",
  "jobsQuery": "Java",
  "jobsTitle": "software engineer",
  "jobsCompany": "Indeed",
  "jobsLocation": "Austin",
  "jobsLocationRadius": 5,
  "fixedEndDate": "2023-10-20",
  "budgetOnetimeLimit": 1000,
  "objective": {
    "objectiveType": "SCHEDULED_INTERVIEWS",
    "target": 77
  }
}

レスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/f261xxxxxxxx6567"
    }]
  },
  "data": {
    "campaignId": "f261xxxxxxxx6567"
  }
}

Indeedで面接キャンペーンを表示します。

Indeedで作成された面接キャンペーン

Indeedで作成された面接キャンペーンの面接目標設定

定期キャンペーンを作成する

前提条件

新しい求人を掲載してから2〜3時間待ってから、キャンペーンを作成してください。
キャンペーンを作成する前に、採用企業アカウントを求人ソースに関連付ける必要があります。アカウントの求人ソースを一覧表示するには、GET /v1/accountを使用します。関連付けられている求人ソースがない場合は、Indeedカスタマーサポートにお問い合わせください。
キャンペーンが求人をスポンサーする前に、採用企業アカウントに有効な請求情報が登録されている必要があります。

この例では、6か月間実行される定期キャンペーンを作成し、月$1500の予算で3か所のマネージャー求人をスポンサーします。

必要なスコープを持つアクセストークンを使用します。

定期キャンペーンを作成する
scope employer_access employer.advertising.campaign
求人ソースIDを取得します。

求人ソースIDを確認するには、採用企業アカウント情報を取得するをご覧ください。採用企業は、Webサイトやドメインごとにそれぞれ1つずつ、複数の求人ソースIDを持つことができます。対象のサイトのjobSourceList.idを使用してください。

定期キャンペーンを作成する
scope	`employer_access employer.advertising.campaign`

定期キャンペーンを作成します。

API詳細:

定期キャンペーンを作成する
API URL	`https://apis.indeed.com/ads/v1/campaigns`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "name": "Test Campaign Recurring",
  "status": "PAUSED",
  "trackingToken": "MyTrackingToken",
  "jobsSourceId": "[Your jobsSourceId from Step 2]",
  "jobsToInclude": "QUERY",
  "jobsQuery": "(city:Aberdeen OR city:Glasgow OR city:London) AND title: Manager",
  "budgetMonthlyLimit": 1500,
  "startDate": "2021-09-01",
  "fixedEndDate": "2022-04-01"
}

レスポンス例:

{
  "meta": {
    "status": 201,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "Campaign Info",
      "href": "/v1/campaigns/52fxxxxxxxxx310"
    }]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedで定期キャンペーンを表示します。

API呼び出し:

Indeedで作成された定期キャンペーンのAPI呼び出し

Indeedで作成されたキャンペーン:

Indeedで作成された定期キャンペーン

定期キャンペーン情報を更新する

この例では、キャンペーンを検索して更新し、別の場所を追加します。このエンドポイントは、キャンペーンの開始や一時停止、キャンペーン名の変更、キャンペーントラッキングトークンの変更にも使用できます。詳細については、スポンサー求人APIリファレンスをご覧ください。

必要なスコープを持つアクセストークンを使用します。

定期キャンペーンを編集する
scope employer_access employer.advertising.campaign

定期キャンペーンを編集する
scope	`employer_access employer.advertising.campaign`

定期キャンペーンのキャンペーンIDを取得するには、採用企業のキャンペーンとステータスを一覧表示します。

API詳細:

定期キャンペーンを更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエストパラメータ:

定期キャンペーン更新のリクエストパラメータ
キー	値
`perPage`	10
`status`	PAUSED
`type`	SOURCE

レスポンス例:

"meta": {
  "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": 10,
  "links": [{
      "rel": "'Test Campaign Single-use' Info",
      "href": "/v1/campaigns/c8bxxxxxxxxx449"
    },
    {
      "rel": "'Test Campaign Recurring' Info",
      "href": "/v1/campaigns/52fxxxxxxxxx310"
    }
  ]
},
"data": {
  "Campaigns": [{
      "Name": "Test Campaign Single-use",
      "Id": "c8bxxxxxxxxx449",
      "Status": "PAUSED"
    },
    {
      "Name": "Test Campaign Recurring",
      "Id": "52fxxxxxxxxx310",
      "Status": "PAUSED"
    }
  ]
}

キャンペーンクエリを更新します。

jobsQueryには、インデックス求人クエリ形式に従ったクエリを渡します。

API詳細:

キャンペーンクエリを更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/:campaignId` （ステップ2の`campaignId`を使用します）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "jobsToInclude": "QUERY",
  "jobsQuery": "(city:Aberdeen OR city:Glasgow OR city:London OR city:Birmingham) AND title: Manager"
}

レスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/52fxxxxxxxxx310"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/52fxxxxxxxxx310/stats"
      }
    ]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedで更新されたキャンペーンを表示します。

API呼び出し:

定期キャンペーンを編集するAPI呼び出し

Indeedで更新されたキャンペーン:

Indeedで更新された定期キャンペーン

キャンペーン予算を更新する

この例では、キャンペーンを検索し、月次予算を$1500から$1750に増額します。

必要なスコープを持つアクセストークンを使用します。

キャンペーン予算を変更する
scope employer_access employer.advertising.campaign
キャンペーンIDを取得します。

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得する手順をご覧ください。

キャンペーン予算を変更する
scope	`employer_access employer.advertising.campaign`

キャンペーン予算を更新します。

API詳細:

キャンペーン予算を更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/:campaignId/budget` （ステップ2の`campaignId`を使用します）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "budgetMonthlyLimit": "1750"
}

レスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/52fxxxxxxxxx310"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/52fxxxxxxxxx310/stats"
      }
    ]
  },
  "data": {
    "campaignId": "52fxxxxxxxxx310"
  }
}

Indeedで更新された予算を表示します。

API呼び出し:

キャンペーン予算を更新するAPI呼び出し

Indeedで更新された予算:

Indeedで更新されたキャンペーン予算

キャンペーン期間を更新する

この例では、単発キャンペーンを検索し、2週間延長します。

必要なスコープを持つアクセストークンを使用します。

キャンペーン期間を変更する
scope employer_access employer.advertising.campaign
キャンペーンIDを取得します。

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得する手順をご覧ください。

キャンペーン期間を変更する
scope	`employer_access employer.advertising.campaign`

キャンペーンの日付を更新します。

API詳細:

キャンペーンの日付を更新する
API URL	`https://apis.indeed.com/ads/v1/campaigns/:campaignId/budget` （ステップ2の`campaignId`を使用します）
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

{
  "fixedEndDate": "2021-09-30"
}

レスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
        "rel": "up",
        "href": "/v1/campaigns"
      },
      {
        "rel": "Campaign Info",
        "href": "/v1/campaigns/c8bxxxxxxxxx449"
      },
      {
        "rel": "Traffic Statistics",
        "href": "/v1/campaigns/c8bxxxxxxxxx449/stats"
      }
    ]
  },
  "data": {
    "campaignId": "c8bxxxxxxxxx449"
  }
}

Indeedで更新された期間を表示します。

API呼び出し:

キャンペーン期間を更新するAPI呼び出し

Indeedで更新されたキャンペーン終了日:

Indeedで更新された終了日

キャンペーン内の求人の詳細を取得する

この例では、キャンペーンがスポンサーする求人の詳細情報を取得します。

必要なスコープを持つアクセストークンを使用します。

キャンペーン内の求人を表示する
scope employer_access employer.advertising.campaign
キャンペーンIDを取得します。

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得するをご覧ください。

キャンペーン内の求人を表示する
scope	`employer_access employer.advertising.campaign`

スポンサー求人の最初のページを取得します。

API詳細:

キャンペーンがスポンサーする求人の最初のページを取得する
API URL	`https://apis.indeed.com/ads/v1/campaigns/:campaignId/jobDetails` （ステップ2の`campaignId`を使用します）
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

リクエスト例:

リクエストパラメータ:

キャンペーン更新のリクエストパラメータ
キー	値
`start`	0
`perPage`	3

レスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.qa.indeed.tech/ads",
    "perPage": 3,
    "links": null
  },
  "data": {
    "entries": [{
        "jobKey": "839d4e5b2b8ca2a6",
        "refNum": "267",
        "title": "Experienced Driver",
        "location": "London"
      },
      {
        "jobKey": "4191b62313a544aa",
        "refNum": "259",
        "title": "Branch Foreman",
        "location": "London"
      },
      {
        "jobKey": "2977cb389f748f51",
        "refNum": "305",
        "title": "Trainee Manager",
        "location": "London"
      }
    ],
    "hash": 964409796
  }
}

残りのページを取得します。

後続のページにも同じリクエスト形式を使用します。次のページを取得するには、前回のstartの値に前回のperPageの値を加算し、perPageは同じ値のままにします。たとえば、最後のページがstart = 10、perPage = 5だった場合、次のページはstart = 15、perPage = 5でリクエストします。

キャンペーンがスポンサーするすべての求人を取得するには、次のいずれかが発生するまで連続するページをリクエストし続けます。
- レスポンスのperPageの値が、リクエストしたperPageと異なる。通常、これは最後のページに到達したことを示します。
  
  perPageの最大値は500であるため、リクエストしたperPageが500を超える場合、レスポンスの値が異なっていても、必ずしも最後のページに到達したことを示すとは限りません。
- レスポンスのhashの値が、前のページと異なる。これは、読み取り中に求人リストが変更されたことを示します。1分間待機してから、start = 0から再開してください。

レポートのハウツーガイド

キャンペーンパフォーマンスをレポートする

この例では、3日間のキャンペーンのパフォーマンスデータをリクエストします。

この例では、集計ビューと日別の内訳の両方が返されます。

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する
scope	`employer_access employer.advertising.campaign_report.read`

キャンペーンパフォーマンスレポートのキャンペーンIDを取得する

キャンペーンを一覧表示するには、定期キャンペーンのキャンペーンIDを取得する手順をご覧ください。

キャンペーン統計を取得する

キャンペーンパフォーマンスレポートのAPI詳細

キャンペーンパフォーマンスレポート
API URL	`https://apis.indeed.com/ads/v1/campaigns/{YourCampaignIdFromStep2}/stats`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

キャンペーンパフォーマンスレポートのリクエストパラメータ

キャンペーンパフォーマンスレポートのリクエストパラメータ
キー	値
`startDate`	2021-07-16
`endDate`	2021-07-31
`merge`	`TRUE` 日別の内訳を取得するには、このフィールドを`FALSE`に設定します。

APIレスポンス（Merge = TRUE）

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": [{
      "rel": "up",
      "href": "/v1/campaigns//b0fxxxxxxxxx327/stats"
    }]
  },
  "data": {
    "Name": "TMN test UK - Target Applies",
    "Id": "/b0fxxxxxxxxx327",
    "StartDate": "2021-07-22",
    "EndDate": "2021-07-24",
    "Clicks": 989,
    "Impressions": 8384,
    "Conversions": 217,
    "CurrencyCode": "USD",
    "Cost": 598.69,
    "OrganicClicks": 35,
    "OrganicImpressions": 303,
    "Applystarts": 320,
    "OrganicApplystarts": 18
  }
}

APIレスポンス（Merge = FALSE）

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 10,
    "links": [
      {
        "rel": "up",
        "href": "/v1/campaigns//b0fxxxxxxxxx327/stats"
      }
    ]
  },
  "data": {
    "entries": [
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-22",
        "Clicks": 373,
        "Impressions": 3238,
        "Conversions": 83,
        "CurrencyCode": "USD",
        "Cost": 258.76,
        "OrganicClicks": 22,
        "OrganicImpressions": 226,
        "Applystarts": 125,
        "OrganicApplystarts": 9
      },
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-23",
        "Clicks": 318,
        "Impressions": 2665,
        "Conversions": 74,
        "CurrencyCode": "USD",
        "Cost": 178.28,
        "OrganicClicks": 7,
        "OrganicImpressions": 42,
        "Applystarts": 104,
        "OrganicApplystarts": 4
      },
      {
        "Name": "TMN test UK - Target Applies",
        "Id": "/b0fxxxxxxxxx327",
        "Date": "2021-07-24",
        "Clicks": 298,
        "Impressions": 2481,
        "Conversions": 60,
        "CurrencyCode": "USD",
        "Cost": 161.65,
        "OrganicClicks": 6,
        "OrganicImpressions": 35,
        "Applystarts": 91,
        "OrganicApplystarts": 5
      }
    ]
  }
}

キャンペーンパフォーマンスレポートのAPI呼び出し

アカウント管理のハウツーガイド

採用企業アカウント情報を取得する

採用企業のID、連絡先情報などを取得します。

採用企業アカウント用のスコープを持つアクセストークンを使用します。

採用企業アカウント情報を取得する
scope employer_access employer.advertising.account.read

アカウントエンドポイントにクエリを実行します。

採用企業アカウントのAPI詳細:

採用企業アカウントのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/account`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

採用企業アカウントのレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": {
    "employerId": "a2973d75fd4xxxxxxx748785257446e7",
    "jobSourceList": [
      {
        "id": "a284xxxxxxx1c1f9",
        "siteName": "MyCompany"
      }
    ],
    "contact": "",
    "company": "My Company Name",
    "id": "4958xxxxxxx3732",
    "email": "myEmailAddress@indeed.com"
  }
}

サブアカウント情報を取得する

特定のマスターアカウントのサブアカウントの詳細な一覧を取得します。

サブアカウント情報用のスコープを持つアクセストークンを使用します。

この操作のアクセストークンを取得する際は、employerパラメータを含めないでください。
サブアカウント情報を取得する
scope
employer.advertising.subaccount.read

サブアカウント情報を取得する
scope	`employer.advertising.subaccount.read`

サブアカウントエンドポイントにクエリを実行します。

サブアカウントエンドポイントにクエリを実行するAPI詳細:

サブアカウントのクエリのAPI詳細
API URL	`https://apis.indeed.com/ads/v1/subaccounts`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

サブアカウントエンドポイントへのクエリのレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": 2,
    "links": {
      "rel": "next",
      "href": "/V1/campaigns/3141xxxxxxxxx793"
    }
  },
  "data": {
    "SubAccountList": {
      "id": "3141xxxxxxxxx793",
      "employerId": "4bc39xxxxxxxxx8efbc8486",
      "company": "MyTestCompany",
      "email": "example@mytestcompany.com"
    }
  }
}

サブアカウントを作成する

マスターアカウントにサブアカウントを追加します。

サブアカウントを作成するためのスコープを持つアクセストークンを使用します。

この操作のアクセストークンを取得する際は、employerパラメータを含めないでください。
サブアカウントを作成する
scope
employer.advertising.subaccount

サブアカウントを作成する
scope	`employer.advertising.subaccount`

サブアカウントエンドポイントを作成します。

サブアカウントエンドポイントを作成するAPI詳細:

サブアカウント作成のAPI詳細
API URL	`https://apis.indeed.com/ads/v1/subaccounts`
リクエストタイプ	`POST`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

サブアカウントエンドポイント作成のリクエスト例:

{
  "email": "testsubaccount@mytestcompany.com",
  "currencyCode": "USD",
  "language": "en",
  "employeeCount": "1-49",
  "company": "MyTestCompany2"
}

サブアカウント作成のレスポンス例:

{
  "meta": {
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": {
    "id": "31xxxxxxxxx794",
    "employerId": "4bc39xxxxxxxxx8efbc8486",
    "company": "MyTestCompany2",
    "email": "testsubaccount@mytestcompany.com",
  }
}

アカウント予算を取得する

アカウントの月次予算を取得します。

アカウント予算用のスコープを持つアクセストークンを使用します。
アカウント予算用のスコープを持つアクセストークンを使用する
scope employer_access employer.advertising.account.read
アカウント予算エンドポイントを取得します。アカウント予算を取得するAPI詳細:
アカウント予算を取得する
API URL https://apis.indeed.com/ads/v1/account/budget
リクエストタイプ GET
コンテンツタイプ application/json
認証 OAuth 2.0ベアラートークン
アカウント予算取得のレスポンス例:
予算が設定されていない場合、jobsMonthlyBudgetレスポンスフィールドはnullを返します。
```
{
  "meta": 
  { 
    "status": 200,
    "errors": null,
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": 
      [
        {
         "rel": "up",
         "href": "/v1/account"
        }
      ],
    "data": 
      {
        "jobsMonthlyBudget": null
      }
  }
}
```

アカウント予算を取得する
API URL	`https://apis.indeed.com/ads/v1/account/budget`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

アカウント予算を設定する

アカウントの月次予算を更新します。

アカウント予算を設定するためのスコープを持つアクセストークンを使用します。
アカウント予算を設定するためのスコープを持つアクセストークンを使用する
scope employer_access employer.advertising.account
アカウント予算エンドポイントにクエリを実行します。
アカウント予算の設定: API詳細:
アカウント予算を設定する
API URL https://apis.indeed.com/ads/v1/account/budget
リクエストタイプ PATCH
コンテンツタイプ application/json
認証 OAuth 2.0ベアラートークン
アカウント予算の設定: リクエスト例:
```
{ "jobsMonthlyBudget": 20000 }
```
アカウント予算の設定: レスポンス例:
```
{
  "meta": &#123;
  "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": null,
  "links": [
    {
      "rel": "up",
      "href": "/v1/account"
    }
  ],
  "data": ""
}
```
この更新を行ってアカウント予算を取得するを呼び出すと、次のレスポンスが返ります。
```
{
  "meta":
  {
    "status": 200,
  "errors": null,
  "rootLocation": "https://apis.indeed.com/ads",
  "perPage": null,
  "links": [
    "rel": "up",
    "href": "/v1/account"
    ],
  "data":
    {
      "jobsMonthlyBudget": 20000.00
    }
  }
}
```
Indeed UIでの求人の月次予算設定:
Indeed UIでの月次予算設定

アカウント予算を設定するためのスコープを持つアクセストークンを使用する
scope	`employer_access employer.advertising.account`

アカウント予算を設定する
API URL	`https://apis.indeed.com/ads/v1/account/budget`
リクエストタイプ	`PATCH`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

APIクォータ使用量のハウツーガイド

広告主のAPIクォータ使用量を取得する

指定した月の広告主のスポンサー求人API使用量、クォータ、およびスポンサー求人の支出を取得します。

当月および過去6か月分を取得できます。API使用回数に当日分は含まれません。支出は、当月については現在までの合計、完了した月についてはその月の合計です。

APIクォータ使用量の詳細用のスコープを持つアクセストークンを使用します。

広告主のAPIクォータ使用量を取得する
scope	`employer_access employer.advertising.account.read`

APIクォータ使用量エンドポイントを呼び出して、APIクォータ使用量を取得します。

広告主のAPIクォータ使用量取得のAPI詳細
API URL	`https://apis.indeed.com/ads/v1/apiquotausage`
リクエストタイプ	`GET`
コンテンツタイプ	`application/json`
認証	OAuth 2.0ベアラートークン

APIクォータ使用量のリクエストパラメータ:

広告主のAPIクォータ使用量取得のリクエストパラメータ
キー	値
`monthYear`	取得するクォータ使用量の月（`MMyyyy`形式）。たとえば、2026年8月は`082026`です。当月、または6か月前までの月を指定する必要があります。任意です。既定値は当月です。

APIクォータ使用量のGETのレスポンス例:

  {
    "meta": {
      "status": 200,
      "errors": null,
      "rootLocation": "https://apis.indeed.com/ads",
      "perPage": null,
      "links": null
    },
    "data": {
      "mmyyyy": "082026",
      "apiQuota": 1500,
      "sponsoredJobsSpendAmount": 3000,
      "currencyCode": "USD",
      "apiUsage": [
        {
          "requestsCount": 1000
        }
      ]
    }
  }

推奨事項とガイドライン

結果整合性に備える

このAPIは結果整合性モデルを採用しています。たとえば、POST /v1/campaignsを呼び出してキャンペーンを作成した直後は、GET /v1/campaigns/{campaignId}が新しいキャンペーンを返さないことが短時間発生する場合があります。

結果整合性に対応するため、リソースを作成または更新した直後にそのリソースを読み取らないでください。成功レスポンス（200、201、またはその他の成功コード）は、Indeedが変更を保存したことを示します。確認のために追加でGETを実行する必要はありません。

作成または更新の直後にリソースを読み取る必要がある場合は、変更が反映されるまで待機するリトライ処理を追加してください。

API変更との互換性を確保する

Indeedは、スポンサー求人APIへの下位互換性のある変更を、事前の通知なしにいつでもリリースできます。下位互換性のある変更には次のものがあります。

レスポンスフィールドの追加。
レスポンスフィールドの並べ替え。
エラー説明の更新。
新しい通貨と目的タイプのサポート。

下位互換性のある変更によって問題が発生しないように、アプリは次のガイドラインに従う必要があります。

JSONレスポンスの不明なプロパティを無視する。
JSONレスポンスのプロパティを任意の順序で受け入れる。
エラーを区別するには、descriptionプロパティではなくtypeプロパティを使用する。

また、アプリのみが管理しているわけではない採用企業アカウントとアプリが連携する場合、別のサードパーティアプリまたはIndeed 求人掲載（新しいウィンドウで開きます）が作成したリソースに遭遇する可能性があります。アプリは次の状況に対応する必要があります。

別のアプリが作成したキャンペーンを取得または更新すると、INCOMPATIBLE_API_VERSIONエラーが返される場合があります。
別のアプリが作成したキャンペーンやサブアカウントは、アプリがサポートしていない通貨コードを使用している場合があります。アプリは、いずれのISO 4217 （新しいウィンドウで開きます）通貨コードも処理できる必要があります。
別のアプリが作成したキャンペーンは、アプリがサポートしていない目的タイプを使用している場合があります。アプリは、予期しない目的タイプに対応するフォールバックロジックを備えている必要があります。

Javaで開発している場合、一般的なJackson （新しいウィンドウで開きます）ライブラリは、デフォルトで不明なプロパティに対して失敗します。この動作を変更するには、@JsonIgnoreProperties(ignoreUnknown = true)を設定します。これにより、DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIESが無効になります。

FAQとトラブルシューティング

FAQ

Indeedはサンドボックス環境を提供していません。本番環境のIndeed APIからデータを読み取ることは、コストやアカウントへの影響なしに可能です。作成・更新操作をテストする場合は、支出を防ぐため、一時停止状態（status=paused）でテストキャンペーンを作成してください。

インデックス求人クエリ形式をご覧ください。

アカウント予算をクリアするには、クライアントサクセス担当者にお問い合わせください。

よくあるエラーをトラブルシューティングする

このトピックでは、スポンサー求人APIが返すエラーについて説明します。https://apis.indeed.com/oauth/v2/tokensなどの認証エンドポイントが返すエラーについては、OAuthエラーのトラブルシューティングをご覧ください。

400から599などの正常でないHTTPステータスコードは、リクエストが失敗したことを示します。レスポンスボディには詳細が含まれます。たとえば、アクセストークンなしでスポンサー求人APIを呼び出すと、次のようなレスポンスが返ります。

{
  "meta": {
    "status": 401,
    "errors": [{
      "type": "INVALID_TOKEN",
      "description": "Couldn't find access token in the request. The Authorization header is missing or incorrectly formatted."
    }],
    "rootLocation": "https://apis.indeed.com/ads",
    "perPage": null,
    "links": null
  },
  "data": null
}

metaレスポンスフィールド内のerrors配列にエラーが含まれます。すべてのエラーにはtypeと人間が読めるdescriptionがあります。この表では、よくあるエラータイプを説明します。

リクエストパスのプレフィックスに/adsが付いていないため、レスポンスはリクエストをスポンサー求人APIにルーティングできなかったことを示します。たとえば、https://apis.indeed.com/v1/accountの代わりにhttps://apis.indeed.com/ads/v1/accountを使用してください。

{
  "fault": {
    "faultstring": "Unable to identify proxy for host: apis and url: /v1/account",
    "detail": {
      "errorcode": "messaging.adaptors.http.flow.ApplicationNotFound"
    }
  }
}

HTTPステータスコード
HTTPステータス	エラータイプ	説明と一般的な原因
`400`	`DATE_RANGE_TOO_LONG`	`startDate`と`endDate`リクエストパラメータの値が離れすぎていることを示します。`endDate`は`startDate`から最大366日後までです。より長い日付範囲のデータが必要な場合は、366日以下のバッチにリクエストを分割してください。このエラーを返すのは、`GET /v1/campaigns/{campaignId}/stats`と`GET /v1/campaigns/{campaignId}/stats/entryDates`のみです。
`400`	`INCOMPATIBLE_API_VERSION`	アプリが呼び出すスポンサー求人APIバージョンと互換性のないリソースを、アプリが取得または更新しています。このエラーは、アプリ外のエンティティがリソースを作成または変更した場合に発生します。このエラーは将来の使用のために予約されており、現在は返されません。
`400`	`INVALID_ADVERTISEMENT_ID`	リクエストに含まれるキャンペーンIDが切り捨てられたり、想定外の文字が含まれていたり、または形式が不正でした。
`400`	`INVALID_REQUEST`	リクエストパラメータのいずれかに問題があります。必須パラメータが欠落している。パラメータの値が無効である。サポートされなくなったパラメータがリクエストに含まれている。リクエストに、一緒に使用できないパラメータの組み合わせが含まれている。 `description`フィールドには通常、問題のあるパラメータ名とより詳細なエラーメッセージが含まれます。例: `{ "meta": { "errors": [{ "type": "INVALID_REQUEST", "description": "jobsToInclude: One of \"all\", \"query\"" }] } }` 他のエラータイプとは異なり、`meta.errors`配列には、問題のあるリクエストパラメータごとに複数の`INVALID_REQUEST`エラーが含まれる場合があります。
`400`	`UNACCEPTED_PARAMETER`	`advertiserId`パラメータを使用してアクセス対象のサブアカウントを指定することはサポートされなくなりました。代わりに、アクセストークンをリクエストする際に`employer`パラメータを含めてください。 `employer`パラメータが受け付ける採用企業IDは、レガシーの`advertiserId`パラメータが受け付ける値とは異なります。`GET /v1/subaccounts`エンドポイントは、サブアカウントの採用企業IDとレガシーIDの両方を返すようになりました。
`400`	`NOT_MASTER_ACCOUNT`	このAPIエンドポイントはマスターアカウントでのみ呼び出せます。現時点では、このエラーは`GET /v1/subaccounts`と`POST /v1/subaccounts`のみから返されます。
`401`	`INVALID_TOKEN`	リクエストに有効なアクセストークンが含まれていません。 `Authorization`ヘッダーが欠落しているか、形式が不正です。アクセストークンは`Authorization` HTTPヘッダーで送信し、値の前に`Bearer`という単語とスペースを付けてください。たとえば、アクセストークンが`XYZ`の場合、リクエストには`Authorization: Bearer XYZ`ヘッダーを含める必要があります。アクセストークンの形式が不正でした。HTTPリクエストを手動で構築してAPIをテストしている場合、リクエストにコピーする際に、アクセストークンの先頭または末尾の文字が欠落したり、余分な文字が含まれていたりしないか確認してください。アクセストークンの有効期限が切れています。アクセストークンは1時間（3,600秒）のみ有効です。それを過ぎたら、クライアントクレデンシャル（2-legged OAuth）またはリフレッシュトークン（3-legged OAuth）を使用して別のアクセストークンを取得する必要があります。
`403`	`EMPLOYER_ACCESS_TOKEN_NOT_ALLOWED`	このAPIエンドポイントは、採用企業を表すアクセストークンではアクセスできません。理由は次のいずれかです。このAPIエンドポイントはマスターアカウントでのみ呼び出せます。この操作のためにアクセストークンをリクエストする際は、`employer`パラメータを省略してください。現時点では、このエラーは`GET /v1/subaccounts`と`POST /v1/subaccounts`のみから返されます。新しいAPIエンドポイントではなく、レガシーのスポンサー求人APIエンドポイントを呼び出しています。必ず新しいエンドポイント（`https://apis.indeed.com/ads`）を使用してください。
`403`	`INSUFFICIENT_SCOPE`	アクセストークンは有効でしたが、このAPIエンドポイントに必要なスコープを持っていませんでした。クライアントクレデンシャルグラントタイプ（2-legged OAuth）を使用している場合: `https://apis.indeed.com/oauth/v2/tokens`を呼び出す際に、`scope`パラメータに必要なスコープを含めませんでした。OAuth手順に戻り、必要なスコープを含むアクセストークンをリクエストしてください。呼び出すエンドポイントに必要なスコープを確認するには、スコープをご覧ください。アプリのアカウントに、この採用企業への管理者アクセスが付与されていません。アプリが持つアクセスレベルは、Manage access （新しいウィンドウで開きます）で確認できます。認可コードグラントタイプ（3-legged OAuth）を使用している場合: ユーザーを`https://secure.indeed.com/oauth/v2/authorize`にリダイレクトする際に、`scope`パラメータに必要なスコープを含めませんでした。呼び出すエンドポイントに必要なスコープを確認するには、スコープをご覧ください。ユーザーがアプリに必要なスコープを付与しなかったか、ユーザーに採用企業への管理者アクセスが付与されていません。これらの条件は、`https://apis.indeed.com/oauth/v2/tokens`から返される`consented_scope`レスポンスフィールドを確認することで区別できます。このフィールドには、採用企業へのアクセスレベルに関係なく、ユーザーがアプリに付与したすべての権限が含まれます。 `GET /v1/account`は特別なケースであることに注意してください。サブアカウントを含む採用企業の詳細を取得するには、必要なスコープは`employer.advertising.account.read`であり、アクセストークンは採用企業を表す必要があります。マスターアカウント自体の詳細を取得するには、必要なスコープは`employer.advertising.subaccount.read`（原文ママ）であり、アクセストークンはユーザーアカウントを採用企業アカウントに紐づけてはいけません。
`403`	`LEGACY_ACCESS_TOKEN_NOT_ALLOWED`	スポンサー求人APIは、レガシーのOAuthエンドポイントを通じて取得したアクセストークンをサポートしなくなりました。更新されたエンドポイントについては、Indeedとの連携とAPIの呼び出しをご覧ください。
`403`	`NOT_EMPLOYER_ACCESS_TOKEN`	`EMPLOYER_ACCESS_TOKEN_NOT_ALLOWED`の逆です。このエンドポイントには、ユーザーアカウントを採用企業アカウントに紐づけるアクセストークンが必要です。アクセストークンをリクエストする際に`employer`パラメータを指定する必要があります。ほとんどのスポンサー求人APIエンドポイントでこの指定が必要です。
`404`	`RESOURCE_NOT_FOUND`	リクエストURLに問題があったことを示します。リクエストされたキャンペーンが存在しないか、別の採用企業に属しています。リクエストされたキャンペーンを所有する採用企業アカウントにユーザーアカウントを紐づけるアクセストークンを必ず使用してください。リクエストされた日付に対応するキャンペーン統計がありません。リクエストされた日付より後にキャンペーンが作成された、リクエストされた日付にキャンペーンがアクティブでなかった、または最近の日付の場合はまだデータが処理中です。リクエストパスのスペルが誤っています。APIリファレンスドキュメントで正しいURLパターンを確認してください。
`500`	すべて（通常は`INTERNAL_SERVER_ERROR`）	想定外のエラー。問題は一時的な場合があります。リトライ後に同じリクエストが成功することがあります。リクエストをリトライしても解決しない場合、リクエストの解析で問題が発生した可能性があります。すべての必須パラメータが含まれており、すべてのパラメータが正しい形式であることを確認してください。クライアントクレデンシャルグラントタイプ（2-legged OAuth）で取得したアクセストークンをレガシーのスポンサー求人APIエンドポイントで使用しようとした場合も、`INTERNAL_SERVER_ERROR`が表示されます。`https://apis.indeed.com/ads`エンドポイントを必ず使用してください。

OAuthエラーをトラブルシューティングする

OAuthエラーのトラブルシューティングをご覧ください。

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

このページの内容

前提条件
キャンペーン管理ガイド
レポートのハウツーガイド
- キャンペーンパフォーマンスをレポートする
アカウント管理のハウツーガイド
APIクォータ使用量のハウツーガイド
- 広告主のAPIクォータ使用量を取得する
推奨事項とガイドライン
- 結果整合性に備える
- API変更との互換性を確保する
FAQとトラブルシューティング
- FAQ
- よくあるエラーをトラブルシューティングする
OAuthエラーをトラブルシューティングする

On this page

前提条件

OAuthを設定する

OAuth v2トークンスコープ

OAuthアクセストークンを取得する

tokensエンドポイントのAPI詳細

tokensエンドポイントのリクエストパラメータ

tokensエンドポイントのレスポンス例

キャンペーン管理ガイド

キャンペーン予算見積もりを取得する

単発キャンペーンを作成する

目標ベースのキャンペーンを作成する

定期キャンペーンを作成する

定期キャンペーン情報を更新する

キャンペーン予算を更新する

キャンペーン期間を更新する

キャンペーン内の求人の詳細を取得する

レポートのハウツーガイド

キャンペーンパフォーマンスをレポートする

キャンペーンパフォーマンスレポートのスコープを持つアクセストークンを使用する

キャンペーンパフォーマンスレポートのキャンペーンIDを取得する

キャンペーン統計を取得する

キャンペーンパフォーマンスレポートのAPI詳細

キャンペーンパフォーマンスレポートのリクエストパラメータ

APIレスポンス（Merge = TRUE）

APIレスポンス（Merge = FALSE）

キャンペーンパフォーマンスレポートのAPI呼び出し

アカウント管理のハウツーガイド

採用企業アカウント情報を取得する

サブアカウント情報を取得する

サブアカウントを作成する

アカウント予算を取得する

アカウント予算を設定する

APIクォータ使用量のハウツーガイド

広告主のAPIクォータ使用量を取得する

推奨事項とガイドライン

結果整合性に備える

API変更との互換性を確保する

FAQとトラブルシューティング

FAQ

よくあるエラーをトラブルシューティングする

OAuthエラーをトラブルシューティングする

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

このページの内容

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