SEEK advertiser IDs

SEEK advertiser IDs

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 “Look up a hirer by ID” section of the Developer Dashboard’s 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
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
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 that will be set for SEEK ANZ hirers.
For example, you can select the SEEK advertiser ID that posted a given PositionProfile :
QueryVariablesResult
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
query ($id: String!) {
  hiringOrganization(id: $id) {
    seekAnzAdvertiserId
    name
  }
}