Docs  Archived  Hirer identifiers
  • No results found

Hirer identifiers

The SEEK API uses opaque object identifier strings to identify SEEK hirers. Your software can programmatically convert between our numeric SEEK advertiser IDs and the new hirer IDs. However, you’re encouraged to directly use hirer IDs whenever possible.The Developer Dashboard hirers page can search for a hirer by either identifier. You can then view all of their identifiers along with their active relationships.

Converting from a SEEK advertiser ID

The seekAnzAdvertiser query looks up a HiringOrganization from a SEEK advertiser ID. You can select the resulting HiringOrganization’s hirer ID:
QueryVariablesResult
CopyGraphQL Explorer
query ($legacyId: Int!) {
  seekAnzAdvertiser(id: $legacyId) {
    id {
      value
    }
  }
}
The hiringOrganizations query will return a paginated list of all the SEEK hirers you have a relationship with. You can select both the id & seekAnzAdvertiserId fields to produce a mapping between the identifiers:
QueryVariablesResult
CopyGraphQL Explorer
query ($schemeId: String!, $first: Int) {
  hiringOrganizations(schemeId: $schemeId, first: $first) {
    edges {
      node {
        id {
          value
        }
        seekAnzAdvertiserId
        name
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Selecting an object’s SEEK advertiser ID

HiringOrganization objects have a seekAnzAdvertiserId field.For example, you can select the SEEK advertiser ID that posted a given PositionProfile:
QueryVariablesResult
CopyGraphQL Explorer
query ($id: String!) {
  positionProfile(id: $id) {
    positionOrganizations {
      seekAnzAdvertiserId
    }
  }
}

Converting to a SEEK advertiser ID

You can directly convert a hirer ID to a SEEK advertiser ID using the hiringOrganization query. This can be useful for exploratory testing or debugging:
QueryVariablesResult
CopyGraphQL Explorer
query ($id: String!) {
  hiringOrganization(id: $id) {
    seekAnzAdvertiserId
    name
  }
}
2022 SEEK API migration: SEEK Application Export
Archived: 2023 Job Posting revision