Phase 2: Object identifiers

Phase 2: Object identifiers

The deprecated Job Posting API uses a few different types of identifiers:
  • Hirers & agents are identified using numeric SEEK advertiser IDs. These are provided by SEEK’s support team when onboarding a new SEEK hirer.
  • Short, human-readable strings are used to specify locations & job categories. These are distributed in an expected values spreadsheet.
  • UUIDs are used to identify job ads after they’ve been posted. The job ad’s UUID is returned in the HTTP response when initially creating the job ad.
By contrast, the SEEK API uses opaque object identifiers to uniquely identify each object in the SEEK API. For example, this is an identifier for a job category in the GraphQL Playground: seekAnzPublicTest:jobCategory:seek:2PiXemmou
Instead of distributing a spreadsheet of expected values, the SEEK API provides GraphQL queries to find input object identifiers. This enables new hirer experiences such as interactively suggesting locations & job categories.
To support your migration, the Job Posting API has been updated to support object identifiers. This allows you to integrate with the new SEEK API objects listed below before migrating from the Job Posting API for managing jobs.

Hirer IDs

The SEEK API uses opaque object identifier strings to identify SEEK hirers. To ease migration to the SEEK API, the Job Posting API accepts hirer object identifiers in the existing thirdParties.advertiserId field.
Hirer ID
Copy
{
  "thirdParties": {
    "advertiserId:": "seekAnzPublicTest:organization:seek:93WyyF1h"
  }
}
For more information, see the SEEK advertiser ID migration guide.

Job ad input objects

Hirers select from a number of associated objects when posting a SEEK job ad:
The deprecated Job Posting API does not support programmatic retrieval of these objects. For some objects, SEEK distributed a spreadsheet of expected values to be hardcoded in your software. For others, the hirer would manually enter an identifier as part of your posting flow.
The SEEK API supports queries to list or suggest these objects in real time. This allows your hirers to use the most up-to-date SEEK datasets when they post their jobs.

Locations

SEEK uses proprietary IDs to specify the location of positions. Precisely locating positions helps candidates search for the most relevant jobs. They are also used as an input into SEEK’s ad pricing.
The Job Posting API uses a location.id field refined with an optional location.areaId. For example, the Melbourne location includes the MelbourneCBDInnerSuburbs area. SEEK’s ANZ location taxonomy had to be manually hardcoded into your software.
The SEEK API uses a multi-level hierarchy from larger parent locations to smaller child locations. Each node in the hierarchy is uniquely identified by a single object identifier. Instead of hardcoding the location hierarchy, you’re encouraged to dynamically retrieve locations via GraphQL queries:
  • locationSuggestions returns an array of likely locations for a provided text string.
  • nearestLocations returns an array of locations closest to the specified latitude & longitude, ordered by distance.
To ease migration to the SEEK API, the Job Posting API accepts location object identifiers in the existing location.id field. The optional location.areaId field should be omitted when using object identifers.
Location OID
Copy
{
  "location": {
    "id": "seekAnzPublicTest:location:seek:2m81wybwV"
  }
}
For more information on locations in the SEEK API, see the locations documentation.

Job categories

Job categories identify the occupational category of a position. Accurately categorising positions helps candidates search for the most relevant jobs. They are also used as an input into SEEK’s ad pricing.
The Job Posting API uses human-readable IDs such as DevelopersProgrammers. SEEK’s ANZ job category taxonomy had to be manually hardcoded into your software.
The SEEK API uses object identifiers and supports programmatic retrieval via GraphQL queries:
To ease migration to the SEEK API, the Job Posting API accepts job category object identifiers in the existing subclassificationId field.
Job category OID
Copy
{
  "subclassificationId": "seekAnzPublicTest:jobCategory:seek:2EFstqFvP"
}
For more information on job categories in the SEEK API, see the job categories documentation.

Branding

Branding allows hirers to promote their company brand on their job ads and application forms. They are manually managed by hirers in the Logos & Brands section of the SEEK employer website.
The Job Posting API has no mechanism to retrieve hirer brands; hirers have to manually enter a logo ID in your posting flow.
The SEEK API supports returning a paginated list of a hirer’s brands using the advertisementBrandings query.
If your system currently supports logos, it passes a numeric logo ID to the Job Posting API:
Numeric logo ID
Copy
{
  "standout": { "logoId": 12345 }
}
To ease migration to the SEEK API, a new string field named brandingId was added to the Job Posting API that accepts a brand OID or a stringified logo ID:
Brand OIDStringified logo ID
Copy
{
  "standout": {
    "brandingId": "globalPublicTest:advertisementBranding:hirerBranding:37EWfWxhwVEGTT5BcjfE2L"
  }
}
For more information on these queries, see the branding documentation.

Questionnaires

A hirer can optionally include a questionnaire for candidates to answer in SEEK’s job application form. Their responses are made available through the Application Export use case. Questionnaires are rendered on SEEK’s candidate website and in our mobile apps.
Some Job Posting API integrations make use of SEEK Screen, a legacy feature that allows hirers to manage questionnaires on the SEEK employer website and manually enter a numeric ID in your posting flow.
The SEEK API does not support SEEK Screen for new integrations. You can either replace the feature with SEEK API questionnaires, or remove it entirely if it sees low usage in your software.

Exit criteria

In order to move to the next phase, you will need to have completed the following:
Criteria
Description
Locations supported
Hirer can select from a list of locations
Job categories supported
Hirer can select from a list of job categories
Branding supported
Hirer can select from a list of brands
Questionnaires supported
Hirer can create a new questionnaire (if applicable)
Job ad posted successfully
Hirer can successfully post a job ad with objects retrieved or created via the SEEK API
Job ad updated successfully
Hirer can successfully update a job ad with objects retrieved or created via the SEEK API