Integration basics

GraphQL basics, best practices, and reference data for Indeed APIs.

Overview

Indeed GraphQL APIs let you request only the data you need. This section covers what you need before you integrate, plus the integration guide for each Indeed API.

---

Get started

1. 1.
   Get started — Set up your integration and make your first API call.
2. 2.
   Authentication — Configure OAuth and manage access tokens.

---

GraphQL at Indeed

1. 1.
   GraphQL at Indeed — Authenticate and call Indeed GraphQL APIs.
2. 2.
   Best practices for GraphQL clients — Build reliable, efficient GraphQL clients.
3. 3.
   Indeed Resource IDs (IRIs) — Look up entities by IRI through the Node interface.
4. 4.
   Webhooks guide — Integrate webhooks to deliver events to your endpoints.
5. 5.
   Troubleshoot GraphQL errors — Diagnose GraphQL errors returned by the API.

---

Reference values

• Language codes, country codes, and locales — Accepted languageCode, countryCode, and locale values, with the display text Indeed shows for each.
• SUIDs — Standardized five-character codes that classify jobs and employers by type, occupation, and attributes.
• SUID reference — All SUID tables in one place.
• SUID change log — Additions and changes to SUID reference tables.

---

API integration guides

• Candidate Sync APIs
  • Employer Registration API integration guide — Integrate the API to register employers to sync candidate data and manage feature settings between their ATS and Indeed.
  • Send Candidates API integration guide — Integrate the API to sync candidate applications with Indeed.
  • Retrieve Candidates API integration guide — Integrate the API to get candidate information on behalf of employers.
• Disposition Sync API
  • Disposition Sync API integration guide — Integrate the API to send job application disposition data to Indeed.
• Hiring Lab API
  • Integrate the Hiring Lab API — Access Indeed Hiring Lab labor market data for analysis and research.
• Indeed Apply
  • XML integrations for direct employers and agencies — Integrate Indeed Apply through an XML feed.
  • Job Sync API integrations for approved partners — Integrate Indeed Apply through the Job Sync API.
• Indeed PLUS (Japan)
  • Employer Data API > Quick start — Create and update employer entities on Indeed and the Indeed PLUS platform. Not available for direct employers.
  • ATS JavaScript Plugin > Load the plugin script — Integrate Indeed features into your ATS site with front-end changes only.
• Job Sync API
  • Job Sync API integration guide — Integrate the API to create and manage job postings on Indeed.

---

GraphQL API reference

• GraphQL API reference — Complete reference for Indeed's GraphQL schema.

---

 

Was this page helpful?