SEEK advertiser IDs

SEEK advertiser IDs

The SEEK API’s new hirer ID is an opaque string prefixed with the hirer’s scheme ID. Unlike the previous numeric advertiser ID, this allows SEEK to uniquely identify its hirers across multiple marketplaces.
If your software will only be used with the SEEK Australia & New Zealand market you can continue to use SEEK advertiser IDs. However, partners are encouraged to migrate to hirer IDs where possible.

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
    }
  }
}

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
  }
}