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

• Sponsored Jobs レガシー API の廃止：

  • 2021-08-01：Indeed OAuth v2 エンドポイントを使用し、可用性が高く低レイテンシのインフラストラクチャで動作する、最新の Sponsored Jobs 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、シークレット、および 3-legged OAuth の認可コード）を確認します。これらの認証情報をアクセストークンと交換し、API 呼び出しを認証します。

OAuth v2トークンスコープ

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

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

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

次をご覧ください。

• ダイレクト連携向けスポンサー求人APIスコープ
• ATS連携向けスポンサー求人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時間以内にキャンペーンを作成してください。それを過ぎると市場環境が変わる可能性があり、キャンペーンの作成には最新の推奨予算が使用されます。
• クエリベースの求人解決によって自動的に追加された求人は、キャンペーン作成後に追加された場合も、推奨予算が日次支出の既定値として使用されます。
• キャンペーンに手動で追加された求人も、推奨予算が日次支出の既定値として使用されます。

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

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か所の求人をスポンサーします。

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

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

   scope	employer_access employer.advertising.campaign

2. 求人ソースIDを取得します。

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

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

   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"
     }
   }

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

   API呼び出し:

   

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

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

   

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

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

前提条件

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

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

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

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

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

   scope	employer_access employer.advertising.campaign

2. 求人ソースIDを取得します。

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

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

   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"
     }
   }

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

   

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

   

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

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

前提条件

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

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

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

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

   scope	employer_access employer.advertising.campaign

2. 求人ソースIDを取得します。

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

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

   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"
     }
   }

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

   API呼び出し:

   

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

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

   

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

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

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

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

   定期キャンペーンを編集する

   scope	employer_access employer.advertising.campaign

2. 定期キャンペーンのキャンペーン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"
       }
     ]
   }

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

   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"
     }
   }

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

   API呼び出し:

   

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

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

   

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

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

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

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

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

   scope	employer_access employer.advertising.campaign

2. キャンペーンIDを取得します。

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

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

   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"
     }
   }

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

   API呼び出し:

   

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

   Indeedで更新された予算:

   

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

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

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

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

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

   scope	employer_access employer.advertising.campaign

2. キャンペーンIDを取得します。

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

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

   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"
     }
   }

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

   API呼び出し:

   

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

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

   

   Indeedで更新された終了日

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

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

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

   キャンペーン内の求人を表示する

   scope	employer_access employer.advertising.campaign

2. キャンペーンIDを取得します。

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

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

   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
     }
   }

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

   後続のページにも同じリクエスト形式を使用します。次のページを取得するには、前回の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呼び出し

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

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

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

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

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

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

   scope	employer_access employer.advertising.account.read

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

   採用企業アカウントの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"
     }
   }

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

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

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

   この操作のアクセストークンを取得する際は、employerパラメータを含めないでください。

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

   scope	employer.advertising.subaccount.read

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

   サブアカウントエンドポイントにクエリを実行する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"
       }
     }
   }

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

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

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

   この操作のアクセストークンを取得する際は、employerパラメータを含めないでください。

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

   scope	employer.advertising.subaccount

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

   サブアカウントエンドポイントを作成する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",
     }
   }

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

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

1. アカウント予算用のスコープを持つアクセストークンを使用します。

   アカウント予算用のスコープを持つアクセストークンを使用する

   scope	employer_access employer.advertising.account.read

2. アカウント予算エンドポイントを取得します。アカウント予算を取得する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
         }
     }
   }

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

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

1. アカウント予算を設定するためのスコープを持つアクセストークンを使用します。

   アカウント予算を設定するためのスコープを持つアクセストークンを使用する

   scope	employer_access employer.advertising.account

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

   アカウント予算の設定: API詳細:

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

   API URL	https://apis.indeed.com/ads/v1/account/budget
   リクエストタイプ	PATCH
   コンテンツタイプ	application/json
   認証	OAuth 2.0ベアラートークン

   アカウント予算の設定: リクエスト例:

   { "jobsMonthlyBudget": 20000 }

   アカウント予算の設定: レスポンス例:

   {
     "meta": {
     "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での月次予算設定

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

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

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

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

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

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

scope	employer_access employer.advertising.account.read

2. 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は、Sponsored Jobs 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エラーのトラブルシューティングをご覧ください。

 

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