Migration guides

Migration guides

The SEEK API replaces a number of legacy SEEK integrations, including the Job Posting API and SEEK Application Export.
Migrating to the SEEK API provides a number of benefits to SEEK and its partners:
  • The SEEK API is a single point of access to SEEK’s hirer marketplace. For example, the same representation of a position is used for job posting, application export and proactive sourcing.
  • Using GraphQL makes it easier for SEEK to introduce new features without disrupting existing integrations. You have the choice of when to broaden your software to take advantage of new SEEK API features.
  • A single set of OAuth2 credentials are used to authenticate your software to the SEEK API. This replaces multiple custom authentication mechanisms that have fallen behind industry best practices.

Using 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
  }
}
Proactive Sourcing
Migration guides
Migration guides