Indeed Resource IDs (IRIs)

An Indeed Resource Identifier (IRI) is a globally unique ID that lets you look up any Indeed entity through the node query.

 

Overview

Objects that implement the GraphQL Node interface can be looked up by their id field through the root-level node and nodes queries. This gives you these benefits:

• You don't need a separate get-by-ID query for each entity type.
• Queries for detail views are simpler.
• Every object has a consistent id field to use as a client cache key.

For this to work, each id must:

• Be unique across all entities. For example, a JobPost and an EmployerRegistration can't share an ID.
• Tell the node query which type of object to return.

Indeed's IDs meet both requirements with the Indeed Resource Identifier (IRI).

---

IRI format

iri://{context}/{entityType}/{internalId}

IRI format

Variable	Value
{context}	The host name of the GraphQL endpoint that resolves the object. For partners, this is always apis.indeed.com.
{entityType}	The case-sensitive name of a type that implements the Node interface. For example, EmployerJob is the entityType for the EmployerJob entities that the Job Update API's findEmployerJobsPartner query returns.
{internalId}	The ID that Indeed uses to retrieve the object from storage. For EmployerJob entities, this is the UUID (sourcedPostingId) that the Job Sync API's createSourcedJobPostings mutation returns.

---

GraphQL API references

• createSourcedJobPostings
• EmployerJob
• EmployerRegistration
• findEmployerJobsPartner
• JobPost
• Node
• node
• nodes
• sourcedPostingId

 

Was this page helpful?