APIの概要
APIの手順
1. 認証する
2. 求人を更新する
3. 求人情報を取得するクエリ方法を選択する
4. ID で求人ステータスを取得する
5. 条件で求人を一覧表示する
リクエスト – 条件で求人を一覧表示する
レスポンス – 条件で求人を一覧表示する
6. 求人の更新をクリアする
7. エラーのトラブルシューティング
求人ステータス
スポンサーなしのオーガニック求人
スポンサー求人
拒否された求人
レート制限
よくある質問
GraphQL APIリファレンス

求人更新APIガイド

Indeed 上の求人の更新、更新のクリア、詳細の取得、一覧表示を行います。

法的注意

このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。

APIの概要

求人更新APIを使用して、Indeed 上の求人の更新、更新のクリア、求人の詳細の取得、求人の一覧表示を行います。これらの呼び出しは無料で、Sponsored Jobs API 使用ポリシーの上限にはカウントされません。

求人の作成と期限切れは ATS が管理します。

APIの手順

1. 認証する

Indeed パートナーになると、Indeed が連携用のアプリを作成します。Partner Console （新しいウィンドウで開きます）にサインインして、アプリと OAuth 認証情報（クライアント ID、シークレット、および 3-legged OAuth の認可コード）を確認します。これらの認証情報をアクセストークンと交換し、API 呼び出しを認証します。

findEmployerJobsPartner、node、nodes の各クエリには、次のいずれかの OAuth トークンタイプが必要です。

OAuth トークンタイプ
トークンタイプ	説明
広告主を指定する 2‑legged OAuth トークン	すでにスポンサー求人APIを client credentials grant type (2-legged OAuth) で使用している場合は、このトークンタイプをすでにお持ちの可能性があります。
3-legged OAuth トークン	すでに 3-legged OAuth トークンをお持ちの場合は、それを使用できます。

アクセストークンには、employer_access スコープと employer.hosted_job スコープが必要です。詳細については、スコープをご覧ください。

アクセストークンを取得したら、クエリにそのトークンを含めます。

更新後の求人ステータスを表示するたびにユーザーがサインインしなくて済むよう、Indeed ではアクセストークンの有効期限が切れる前に更新することを推奨しています。

2. 求人を更新する

遅延公開を使用している場合、更新が成功すると保留された求人も公開されます。

Indeedの求人のupsertとupdateの使い分け

自社がIndeedに送信した求人は、upsertします。
別のパートナーが送信した求人は、updateします。updateは主に広告代理店向けです。

日本のみ：広告代理店およびIndeed PLUSパブリッシャーネットワークのパートナーを除き、すべてのパートナーが求人をupdateできます。

リクエスト – 求人を更新する

求人の一部のフィールドを更新するには、jobsIngest.updateSourcedJobPostings ミューテーションを呼び出します。

この操作には、employer_access スコープと employer.hosted_job スコープを持つ、広告主を表すアクセストークンが必要です。採用企業を表すアクセストークンを取得するをご覧ください。その際、採用企業 ID ではなく広告主 ID をトークンに関連付けます。

更新したいフィールドのみを指定します。フィールドを変更しない場合は、省略するか null を設定します。

次の例では、updateSourcedJobPostings ミューテーションを呼び出して、求人の複数のフィールドを更新します。

mutation UpdateSourcedJobPostings {
  jobsIngest {
    updateSourcedJobPostings(
      input: {
        updates: [
          {
            sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
            metadata: {
              url: "https://www.example.com/jobs/123"
              campaignCategories: ["springCampaign"]
              trackingUrl: "https://www.example.com/jobs/123?utm_source=indeed"
            }
            body: {
              title: "Software Developer"
              description: "Come build the future with us!"
              jobLocation: {
                general: {
                  cityRegionPostal: "Phoenix, AZ 85003"
                  streetAddress: "1234 Sunny Lane, Phoenix, AZ 85003"
                }
              }
              salary: {
                currency: "USD"
                maximumMinor: 1000
                minimumMinor: 1000
                period: "HOUR"
              }
            }
          }
        ]
      }
    ) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

mutation UpdateSourcedJobPostings {
  jobsIngest {
    updateSourcedJobPostings(input: {
      updates: [{
        sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
        body: {
          description: "<h2>About the role</h2><p>Join our team as a software engineer. You design and build scalable backend services.</p><ul><li>Competitive salary</li><li>Remote-friendly</li><li>Health and dental benefits</li></ul>"
          descriptionFormatting: HTML
        }
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

updateSourcedJobPostings は、UpdateSourcedJobPostingsInput 型の input という 1 つの引数を取ります。

input には updates という 1 つのフィールドがあり、これは UpdateSourcedJobPostingInput オブジェクトの配列です。各オブジェクトは、1 件の求人に対する更新内容を定義します。

各 UpdateSourcedJobPostingInput オブジェクトは、次のフィールドをサポートします。

リクエスト – 求人を更新する
フィールド	タイプ	説明
`sourcedPostingId`	`ID!`	必須。求人ごとに、次のいずれかの値を指定します。 `SourcedJobPosting.sourcedPostingId`（`jobsIngest.createSourcedJobPostings` が返します）。求人を作成するをご覧ください。 `EmployerJob.id`（`findEmployerJobsPartner` が返します）。条件で求人を一覧表示するをご覧ください。
`metadata.url`	`WebUrl`	Indeed エントリーを利用できない場合に、求職者が応募できる広告代理店の URL です。
`metadata.campaignCategories`	`[String!]`	キャンペーン選択のために関連する求人をグループ化するカテゴリータグです。指定した値については、`ad_campaign_category:{category}` でスポンサー求人APIにクエリを実行します。
`metadata.trackingUrl`	`WebUrl`	求人のトラッキング URL です。求職者が Indeed 上でその求人を表示すると、Indeed はこの URL に HTTP リクエストを送信します。
`body.title`	`String`	求人のタイトルです。
`body.description`	`String`	求人の説明です。プレーンテキスト (`TEXT`): 30 ～ 20,000 文字 HTML (`HTML`): 最小 30 文字、最大 65,000 UTF-8 バイト。上限はバイト単位のため、マルチバイト文字も上限に含まれます。サポートされているタグについては、求人説明の書式をご覧ください。このフィールドを変更しない場合は、省略するか `null` を設定します。
`body.descriptionFormatting`	`DescriptionFormatting`	求人の説明の形式です。HTML 形式を有効にするには、このフィールドに `HTML` を設定します。デフォルトは `TEXT` です。
`body.jobLocation` `.general.cityRegionPostal`	`String!`	勤務地を更新する場合は必須。求人の市区町村、都道府県、州、郡などの行政区分、および郵便番号です。リモート求人にこのフィールドを設定すると、Indeed はその求人を地域限定のリモート求人として扱います。
`body.jobLocation` `.general.streetAddress`	`String`	求人の主な勤務地の番地です。Indeed が勤務地のマッチングを改善し、求職者に住所を表示できるよう、完全な住所を指定してください。
`body.salary.currency`	`CurrencyCode`	ISO 4217 形式の給与の通貨コードです。
`body.salary.maximumMinor`	`Int64`	現地通貨の補助単位で表した給与の上限です。USD の場合、`1000` は 10 ドルを表します。現在の値をクリアするには、このフィールドを省略するか `null` を設定します。
`body.salary.minimumMinor`	`Int64`	現地通貨の補助単位で表した給与の下限です。USD の場合、`1000` は 10 ドルを表します。現在の値をクリアするには、このフィールドを省略するか `null` を設定します。
`body.salary.period`	`JobSalaryPeriod!`	給与を更新する場合は必須。時給、日給、週給など、給与の計算に使用する単位です。
`body.companyName`	`String`	求人の会社名を更新します。変更しない場合は、このフィールドを省略するか `null` を設定します。最大長は 200 文字です。

詳細については、API リファレンスをご覧ください。

更新内容を確認する

updateSourcedJobPostings のレスポンスには求人 IRI が含まれます。変更を確認するには、返された IRI を指定して node クエリを使用します。

ID で求人ステータスを取得するをご覧ください。

部分的な更新

フィールドの更新はアトミックではありません。1 回のリクエストで複数のフィールドを更新した場合、まれに一部の変更のみが適用されることがあります。その場合、レスポンスにエラーが含まれます。

エラーレスポンスが返っても、必ず部分的な更新が発生したとは限りません。複数フィールドのリクエストでエラーが返された場合は、更新後の求人を表示して、どのフィールドが成功したかを確認してください。エラー処理の方法については、GraphQL エラーをトラブルシューティングするをご覧ください。

レスポンス – 求人を更新する

updateSourcedJobPostings は UpdateSourcedJobPostingsPayload オブジェクトを返します。このオブジェクトには results フィールドが含まれ、これは UpdateSourcedJobPostingResult オブジェクトの配列です。各オブジェクトは、1 件の求人の更新に対応します。

各 UpdateSourcedJobPostingResult オブジェクトには、SourcedJobPostingUpdate 型の jobPosting フィールドが含まれます。Indeed が更新を受け付けない場合、このフィールドは null です。それ以外の場合は、次の値が含まれます。

sourcedPostingId: 求人の UUID です。これは、Indeed が求人を作成したときに生成した SourcedJobPosting.sourcedPostingId と一致します。この値を使用して、求人を期限切れにしたり更新したりします。
employerJobId: 求人の Indeed Resource Identifier (IRI) です。これは EmployerJob.id と一致します。

3. 求人情報を取得するクエリ方法を選択する

求人情報を取得するには、次のいずれかの方法を使用します。

ID で求人ステータスを取得する（node クエリまたは nodes クエリ）

求人 IRI（EmployerJob の ID）がすでにある場合は、この方法を使用します。IRI がすでに分かっている場合は、findEmployerJobsPartner よりも高速です。

ユースケース:
- 更新の確認: updateSourcedJobPostings を呼び出して求人 IRI を取得し、node で変更を確認します。
- Webhook の処理: Webhook を受信した後、ペイロードに含まれる求人 IRI を指定して node を使用し、現在の求人の状態を取得します。
条件で求人を一覧表示する（findEmployerJobsPartner）

すべての求人を一覧表示するには、この検索ベースの方法を使用します。求人在庫の一括取得に最適です。

ユースケース:
- 在庫の同期: IRI がない場合は、findEmployerJobsPartner を呼び出して関連する求人を一括で取得します。使用できるフィルターは legacySourceId と feedType のみです。

4. ID で求人ステータスを取得する

IRI（EmployerJob の ID）で求人ステータスを取得するには、GraphQL の node クエリまたは nodes クエリを呼び出します。IRI がすでに分かっている場合は、条件で求人を一覧表示する方法よりも高速です。求人 IRI は base64 でエンコードされています。

認証

findEmployerJobsPartner と同じ認証と認可を使用します。認証するをご覧ください。

単一求人のクエリ (node)

Relay Node パターンを使用して、IRI で 1 件の求人を取得します。

query GetJob($id: ID!) {
  node(id: $id) {
    ...on EmployerJob {
      id
      jobData {
        title
        description
        company
        dateCreated
        datePostedOnIndeed
        jobLocation {
          city
          countryCode
          fullAddress
        }
        salary {
          max
          min
          period
        }
        externalPostingMetadata {
          jobPostingId
          jobRequisitionId
        }
      }
      managementUrls {
        viewJob
      }
    }
  }
}

変数:

{
  "id": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA="
}

レスポンスの id フィールドは、エンコードされた IRI です。EmployerJob をご覧ください。

POST https://apis.indeed.com/graphql
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "query": "query GetJob($id: ID!) { node(id: $id) { ... on EmployerJob { id jobData { title description company } } } }",
  "variables": {
    "id": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA="
  }
}

複数求人のクエリ (nodes)

IRI で複数の求人のステータスを取得します。複数の更新をまとめて確認する場合や、Webhook イベントをバッチ処理する場合は、このクエリを使用します。

query GetMultipleJobs($ids: [ID!]!) {
  nodes(ids: $ids) {
    ... on EmployerJob {
      id
      jobData {
        title
        description
        company
        datePostedOnIndeed
        jobLocation {
          city
          countryCode
        }
      }
    }
  }
}

変数:

{
  "ids": [
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA=",
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjpiMmMzZDRlNS1mNmE3LTg5MDEtYmNkZS1mMjM0NTY3ODkwMTI=",
    "dXJuOmluZGVlZDplbXBsb3llcmpvYjpjM2Q0ZTVmNi1hN2I4LTkwMTItY2RlZi0zNDU2Nzg5MDEyMzQ="
  ]
}

レスポンスの id フィールドは、エンコードされた IRI です。EmployerJob をご覧ください。

Webhook を使用する

Webhook のペイロードには、求人 IRI が含まれます。

{
  "eventType": "job.updated",
  "jobIri": "dXJuOmluZGVlZDplbXBsb3llcmpvYjphMWIyYzNkNC1lNWY2LTc4OTAtYWJjZC1lZjEyMzQ1Njc4OTA=",
  "timestamp": "2025-12-10T15:30:00Z"
}

IRI を指定して node クエリを使用し、現在の求人ステータスを取得します。単一求人のクエリ (node) をご覧ください。

5. 条件で求人を一覧表示する

この機能を使用するには、Indeed にお問い合わせください。追加の要件があります。

雇用主の求人を一覧表示します。

クライアントごとに 1 時間に 1 回この操作を呼び出す場合は、レート制限に達する可能性は低くなります。HTTP 429 が返された場合は、リクエストの頻度を下げてください。この呼び出しのレート制限については、レート制限をご覧ください。

リクエスト – 条件で求人を一覧表示する

採用企業の求人を一覧表示するには、findEmployerJobsPartner を呼び出します。

次の例では、findEmployerJobsPartner を呼び出して、Indeed への掲載日の降順で求人を一覧表示します。

query FindEmployerJobsPartner {
  findEmployerJobsPartner(input: {
    filters: {
      legacySourceId: "60a9614a5d973a21",
      jobFeedType: ["INTEGRATED_FROM_PARTNER"]
    },
    sort: [{
      sortDirection: DESC,
      sortField: datePostedOnIndeed
    }]
  }, first: 10, before: null, after: null) {
    employerJobs {
      id
      jobData {
        title
        datePostedOnIndeed
        dateCreated
        description
        company
        jobLocation {
          countryCode
          city
          postalCode
          fullAddress
        }
        externalJobPageUrl
        externalPostingMetadata {
          jobPostingId
          jobRequisitionId
          campaignCategories
          trackingUrls
          rawInputLocation
          isIntegratedJob
        }
      }
      managementUrls {
        viewJob
      }
      seatsConnection {
        pageInfo {
          endCursor
          hasNextPage
          hasPreviousPage
          startCursor
        }
        seats {
          jobPost {
            status(input: { # Required input for messages to appear
              surfaceContexts: [{
                statusCommunicationSettings: {
                  communicationLocale: "en"
                }
              }]
            }) {
              surfaceStatuses {
                isRejected
                statusCommunication {
                  messagingTagMatches {
                    # Returns a rejection reason if a message is found.
                    message
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

findEmployerJobsPartner は、ソース ID で求人を検索するか、採用企業の求人を一覧表示します。次の入力フィールドをサポートします。

条件で求人を一覧表示するフィールド
フィールド	説明
`input.filters.jobFeedType`	求人の取得元を示すフィードタイプで求人をフィルタリングします。有効な値は次のとおりです。 `CREATED_ON_INDEED` – Indeed 上で作成された求人です。 `INTEGRATED_FROM_PARTNER` – XML フィードまたは求人情報連携API からの求人です。 `CRAWLED_FROM_WEB` – ウェブ上で見つかった求人です。 `UNKNOWN` – 未分類の求人です。直接のソースデータがない求人と、2025年6月1日より前の求人のうち分類されなかったものが含まれます。指定できる値は 1 つです。ただし、`UNKNOWN` は他の 1 つのタイプと組み合わせて指定できます。デフォルト: `INTEGRATED_FROM_PARTNER` デフォルトでは、`findEmployerJobsPartner` は XML や API フィードなどの連携からの求人のみを返します。クライアントの求人がウェブからクロールされている場合や Indeed 上でホストされている場合は、このフィルターを適切に設定してください。詳細については、シナリオ 2: クロール求人またはホスト求人とサブアカウントをご覧ください。
`input.filters.jobRequisitionId`	求人に指定された ATS の採用管理 ID（`externalPostingMetadata.jobRequisitionId`）で求人をフィルタリングします。このフィールドが返す値をそのまま送信してください。照合では大文字と小文字を区別せず、前後の空白も除去されません。 `123` のような部分文字列は、それを含むすべての ID に一致します。複数の値を指定した場合は OR で結合されます。採用管理 ID は一意ではないため、1 つのフィルターが複数の求人に一致することがあります。デフォルトでは、`findEmployerJobsPartner` は XML や API フィードなどの連携からの求人のみを返します。詳細については、シナリオ 2: クロール求人またはホスト求人とサブアカウントをご覧ください。
`input.sort`	レスポンス内の求人の並び順を定義するオブジェクトの配列です。各オブジェクトには、次のフィールドがあります。 `sortDirection`: 求人を `ASC` または `DESC` のどちらの順序で一覧表示するかを制御します。デフォルト: `ASC`。 `sortField`: 求人の並び替えに使用するフィールドを定義します。このフィールドを省略すると、`sortDirection` は効果を持ちません。
`first`	返す求人の件数です。デフォルト: 10 最大: 500
`before`	この値より前のカーソル値を持つ項目を返します。ページネーションの詳細については、レスポンスの `PageInfo` を使用してください。
`after`	この値より後のカーソル値を持つ項目を返します。ページネーションの詳細については、レスポンスの `PageInfo` を使用してください。

レスポンス – 条件で求人を一覧表示する

findEmployerJobsPartner は、アクセストークンに関連付けられた採用企業の求人を、指定したフィルターと並び替えを適用して一覧表示します。

リクエストにフィルターや並び替えを含めた場合、API はそれらを結果に適用します。

この例ではシート 1 件が返されるため、pageInfo の startCursor と endCursor は一致し、hasNextPage と hasPreviousPage は false です。

{
  "data": {
    "findEmployerJobsPartner": {
      "employerJobs": [{
        "id": "aXJpOi8vYXBpcy5pbmRlZWQuY29tL0VtcGxveWVySm9iLzkxZGU0ZjVhLWE1MWYtNGQ1Ni1iOWI0LWNhMDQzZWVjNDAzMQ==",
        "jobData": {
          "title": "Certified Nursing Assistant CNA",
          "externalPostingMetadata": {
            "jobPostingId": "CBA-Anytown-Posting-Id",
            "jobRequisitionId": "CBA-Anytown-Req-Id"
          },
          "managementUrls": {
            "viewJob": "https://www.example.com/"
          }
        },
        "seatsConnection": {
          "pageInfo": {
            "endCursor": "abc123",
            "hasNextPage": false,
            "hasPreviousPage": false,
            "startCursor": "abc123"
          },
          "seats": [{
            "jobPost": {
              "status": {
                "surfaceStatuses": [{
                  "isRejected": true,
                  "isSponsorshipRequired": false,
                  "isMissingRequiredSponsorship": false,
                  "statusCommunication": {
                    "messagingTagMatches": [{
                      "message": "Your job post appears to violate our policy guidelines and is not eligible to be shown in our search results."
                    }]
                  }
                }]
              }
            }
          }]
        }
      }]
    }
  }
}

トークンで期待した求人が返らない場合は、Indeed の採用企業アカウントページから Indeed のサポート担当者に問い合わせるようユーザーに依頼してください。必要に応じて、担当者が Indeed 上の求人と広告主またはユーザーアカウントの関連付けを支援できます。

API は、次のフィールドを持つ FindEmployerJobsPartnerConnection オブジェクトを返します。

レスポンス – 条件で求人を一覧表示する
フィールド	タイプ	説明
`employerJobs`	`[EmployerJob]!`	求人オブジェクトの配列です。フィールドの詳細については、レスポンス – IDで求人ステータスを取得するをご覧ください。
`estimatedTotalResultsCount`	`Int!`	レスポンスに含まれる求人の推定総数です。
`pageInfo`	`PageInfo!`	ページネーション情報です。

検証エラーのトラブルシューティングについては、GraphQL エラーをトラブルシューティングするをご覧ください。詳細については、GraphQL ドキュメントの Validation （新しいウィンドウで開きます）をご覧ください。

6. 求人の更新をクリアする

広告代理店は、この操作を使用して、クライアントの求人に対して行った更新をクリアします。求人は最新の ATS データに戻るため、クライアントは他の Indeed のツールで再びその求人を管理できます。たとえば、クライアントとの取引を終了する場合に、自社が行った更新をクリアします。

求人を更新する

クライアントを追加し、その求人を更新します。
条件で求人を一覧表示する

findEmployerJobsPartner を呼び出して、更新後の値を確認します。legacySourceId には、更新操作が返した sourcedPostingId を設定します。
求人の更新をクリアする

clearSourcedJobPostingUpdates を呼び出して、更新したフィールドをクリアします。
条件で求人を一覧表示する

同じ legacySourceId を指定して findEmployerJobsPartner をもう一度呼び出し、フィールドが ATS データを表示していることを確認します。

この呼び出しのレート制限については、レート制限をご覧ください。

リクエスト – 求人の更新をクリアする

updateSourcedJobPostings で以前に変更したフィールドをクリアするには、jobsIngest.clearSourcedJobPostingUpdates ミューテーションを呼び出します。

この操作には、employer_access スコープと employer.hosted_job スコープを持つ、元の更新を行った広告主のアクセストークンが必要です。採用企業を表すアクセストークンを取得するをご覧ください。その際、採用企業 ID ではなく広告主 ID をトークンに関連付けます。

次の例では、clearSourcedJobPostingUpdates ミューテーションを呼び出して、求人の更新をクリアします。

mutation ClearSourcedJobPostingUpdates {
  jobsIngest {
    clearSourcedJobPostingUpdates(input: {
      updates: [{
        sourcedPostingId: "<SOURCED POSTING ID OF JOB POSTING>"
      }]
    }) {
      results {
        jobPosting {
          sourcedPostingId
          employerJobId
        }
      }
    }
  }
}

clearSourcedJobPostingUpdates は、ClearSourcedJobPostingUpdatesInput 型の input という 1 つの引数を取ります。

input には updates という 1 つのフィールドがあり、これは ClearSourcedJobPostingUpdateInput オブジェクトの配列です。各オブジェクトは、更新をクリアする求人を 1 件指定します。

1 回のリクエストで複数の求人の更新をクリアするには、複数の ClearSourcedJobPostingUpdateInput オブジェクトを指定します。

各 ClearSourcedJobPostingUpdateInput オブジェクトは、次のフィールドをサポートします。

リクエスト – 求人の更新をクリアする
フィールド	タイプ	説明
`sourcedPostingId`	`ID!`	必須。求人ごとに、次のいずれかの値を指定します。 `SourcedJobPosting.sourcedPostingId`（`jobsIngest.createSourcedJobPostings` が返します）。求人を作成するをご覧ください。 `EmployerJob.id`（`findEmployerJobsPartner` が返します）。条件で求人を一覧表示するをご覧ください。

レスポンス – 求人の更新をクリアする

clearSourcedJobPostingUpdates は ClearSourcedJobPostingUpdatesPayload オブジェクトを返します。このオブジェクトには results フィールドが含まれ、これは ClearSourcedJobPostingUpdateResult オブジェクトの配列です。各オブジェクトは、更新をクリアした求人 1 件に対応します。

各 ClearSourcedJobPostingUpdateResult オブジェクトには、SourcedJobPostingUpdate 型の jobPosting フィールドが含まれます。Indeed がリクエストを受け付けない場合、このフィールドは null です。それ以外の場合は、次の値が含まれます。

sourcedPostingId: 求人の UUID です。これは、Indeed が求人を作成したときに生成した SourcedJobPosting.sourcedPostingId と一致します。この値を使用して、求人を期限切れにしたり更新したりします。
employerJobId: 求人の Indeed Resource Identifier (IRI) です。これは EmployerJob.id と一致します。

7. エラーのトラブルシューティング

求人更新API固有のエラーについては、エラーのトラブルシューティングをご覧ください。
GraphQL に到達する前に発生する OAuth エラーについては、OAuth エラーのトラブルシューティングをご覧ください。
GraphQL エラーについては、GraphQL エラーをトラブルシューティングするをご覧ください。

求人ステータス

フィードポリシーが変更されたため、Indeed 上で管理する求人の多くは、自社のフィード由来ではなくなりました。

求人のステータスは、次のいずれかです。

オーガニック: isRejected と isSponsorshipRequired がどちらも false です。スポンサーなしのオーガニック求人をご覧ください。
スポンサー求人のみ（消費あり）: isRejected が false、isSponsorshipRequired が true、isMissingRequiredSponsorship が false です。スポンサー求人をご覧ください。
スポンサー求人のみ（消費なし）: isRejected、isSponsorshipRequired、isMissingRequiredSponsorship がすべて true です。スポンサー求人をご覧ください。
どこにも表示されない: isRejected が true、isSponsorshipRequired が false です。拒否された求人をご覧ください。

スポンサーなしのオーガニック求人

スポンサー求人ではない求人のオーガニックトラフィックのデータを取得するには、次のいずれかの方法を使用します。

trackingUrl フィールドを追加する: 求人のクリックごとに HTTP リクエストを受け取ります。オーガニックトラフィックとスポンサートラフィックのどちらでも、また Indeed エントリーを使用しているかどうかにかかわらず機能します。UpdateSourcedJobPostingMetadataInput の trackingUrl をご覧ください。
カスタムの求人 URL を使用する: 求人 URL を自社が所有する採用ページに置き換えるか、ATS パートナーと連携してトラッキング用のメタデータを付加します。求職者がこの URL に移動するのは、求人が Indeed エントリーを使用していない場合のみです。UpdateSourcedJobPostingMetadataInput の url をご覧ください。
クライアントの ATS と連携する: クライアントおよびそのクライアントの ATS と連携して、オーガニックのパフォーマンスデータを収集します。
クライアントに Indeed Analytics にサインインしてもらう: クライアントは、スポンサー求人かどうかにかかわらず、すべての求人の完全なオーガニックパフォーマンスを確認できます。

スポンサー求人

スポンサー求人のトラフィックデータを取得するには、スポンサー求人API v8 以降を呼び出して、求人更新APIが返す ID と一致する採用企業の求人 ID を取得します。

拒否された求人

ベータ

この機能はベータ版です。ベータプログラムへの参加をご希望の場合は、Indeed の担当者に連絡してください。この機能が一般提供されたら、Indeed からお知らせします。

isRejected が true で isSponsorshipRequired が false の場合、その求人は Indeed で検索できません。理由と対処方法を確認するには、ステータスメッセージを取得します。

findEmployerJobsPartner を呼び出して、条件で求人を一覧表示するを実行します。

次の例では、findEmployerJobsPartner を呼び出して、Indeed への掲載日の降順で求人を一覧表示します。

query FindEmployerJobsPartner {
  findEmployerJobsPartner(input: {
    filters: {
      legacySourceId: "60a9614a5d973a21",
      jobFeedType: ["INTEGRATED_FROM_PARTNER"]
    },
    sort: [{
      sortDirection: DESC,
      sortField: datePostedOnIndeed
    }]
  }, first: 10, before: null, after: null) {
    employerJobs {
      id
      jobData {
        title
        externalPostingMetadata {
          jobPostingId
          jobRequisitionId
        }
      }
      seatsConnection {
        seats {
          jobPost {
            status(input: { # Required input for messages to appear
              surfaceContexts: [{
                statusCommunicationSettings: {
                  communicationLocale: "en"
                }
              }]
            }) {
              surfaceStatuses {
                isRejected
                isSponsorshipRequired
                isMissingRequiredSponsorship
                statusCommunication {
                  messagingTagMatches {
                    # Returns a rejection reason if a message is found.
                    message
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

レスポンスで、JobPostSurfaceStatus.isRejected が true で、JobPostSurfaceStatus.isSponsorshipRequired が false の求人を探します。

以降の API 呼び出しのために EmployerJob.id を保存します。

拒否の理由は、JobPostStatusMessagingTagMatch.message（JobPostSurfaceStatus.statusCommunication 内）で確認します。このメッセージは、問題の内容を説明するものであり、原因となったルールを示すものではありません。

{
  "data": {
    "findEmployerJobsPartner": {
      "employerJobs": [{
        "id": "aXJpOi8vYXBpcy5pbmRlZWQuY29tL0VtcGxveWVySm9iLzkxZGU0ZjVhLWE1MWYtNGQ1Ni1iOWI0LWNhMDQzZWVjNDAzMQ==",
        "jobData": {
          "title": "Certified Nursing Assistant CNA",
          "externalPostingMetadata": {
            "jobPostingId": "CBA-Anytown-Posting-Id",
            "jobRequisitionId": "CBA-Anytown-Req-Id"
          }
        },
        "seatsConnection": {
          "seats": [{
            "jobPost": {
              "status": {
                "surfaceStatuses": [{
                  "isRejected": true,
                  "isSponsorshipRequired": false,
                  "isMissingRequiredSponsorship": false,
                  "statusCommunication": {
                    "messagingTagMatches": [{
                      "message": "Your job post appears to violate our policy guidelines and is not eligible to be shown in our search results."
                    }]
                  }
                }]
              }
            }
          }]
        }
      }]
    }
  }
}

レート制限

求人更新APIでは、次の操作にレート制限が適用されます。

Indeed は、API の可用性を維持するため、求人更新APIの通常の 1 日の使用量を上回る値を制限として設定していますが、短期間に大量のリクエストが発生した場合はスロットリングを行います。そのため、リクエストを 10 分間に分散してください。

制限を超えると、API は HTTP レスポンスまたは GraphQL の JSON errors 配列のいずれかで HTTP 429 を返します。リクエストの頻度を下げてください。これらの制限への対処についてサポートが必要な場合は、サポートをリクエスト（新しいウィンドウで開きます）してください。

制限は次のとおりです。

求人更新APIのレート制限
クエリまたはミューテーション	レート制限
`findEmployerJobsPartner` クエリ	1 秒あたり 5 リクエスト
`jobsIngest.updateSourcedJobPostings` ミューテーション	2 つのミューテーション合計で 1 秒あたり 20 リクエスト
`jobsIngest.clearSourcedJobPostingUpdates` ミューテーション	2 つのミューテーション合計で 1 秒あたり 20 リクエスト

よくある質問

Job visibility

求人でIndeed エントリーが使用されている場合、EmployerJob.seatConnections.jobPost.isIndeedApplyActiveはtrueを返します。パートナーはfindEmployerJobsPartnerでこのフィールドを取得できます。

Job UpdateIndeed Apply

GraphQL APIリファレンス

clearSourcedJobPostingUpdates — 求人の更新をクリアします。
findEmployerJobsPartner — 採用企業の求人を一覧表示します。
node — ID で 1 件の求人を取得します。
nodes — ID で複数の求人を取得します。
publishSourcedJobPostings。
updateSourcedJobPostings — サポートされている求人フィールドを更新します。

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

On this page

APIの概要​

APIの手順​

1. 認証する​

2. 求人を更新する​

リクエスト – 求人を更新する​

更新内容を確認する​

部分的な更新​

レスポンス – 求人を更新する​

3. 求人情報を取得するクエリ方法を選択する​

4. ID で求人ステータスを取得する​

認証​

単一求人のクエリ (node)​

複数求人のクエリ (nodes)​

Webhook を使用する​

5. 条件で求人を一覧表示する​

リクエスト – 条件で求人を一覧表示する​

レスポンス – 条件で求人を一覧表示する​

6. 求人の更新をクリアする​

リクエスト – 求人の更新をクリアする​

レスポンス – 求人の更新をクリアする​

7. エラーのトラブルシューティング​

求人ステータス​

スポンサーなしのオーガニック求人​

スポンサー求人​

拒否された求人​

レート制限​

よくある質問​

Job visibility​

GraphQL APIリファレンス​

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

このページの内容

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

APIの概要

APIの手順

1. 認証する

2. 求人を更新する

リクエスト – 求人を更新する

更新内容を確認する

部分的な更新

レスポンス – 求人を更新する

3. 求人情報を取得するクエリ方法を選択する

4. ID で求人ステータスを取得する

認証

単一求人のクエリ (node)

複数求人のクエリ (nodes)

Webhook を使用する

5. 条件で求人を一覧表示する

リクエスト – 条件で求人を一覧表示する

レスポンス – 条件で求人を一覧表示する

6. 求人の更新をクリアする

リクエスト – 求人の更新をクリアする

レスポンス – 求人の更新をクリアする

7. エラーのトラブルシューティング

求人ステータス

スポンサーなしのオーガニック求人

スポンサー求人

拒否された求人

レート制限

よくある質問

Job visibility

GraphQL APIリファレンス