SEEK Developer

This content provides an early look at an upcoming extension to the SEEK API. You may use it to scope integration effort, but the features described are not fully implemented and may be adjusted ahead of a production release.Check with your SEEK contact before starting any build work described here.

After your software has opened a position, the SEEK API can notify you when Ad Sync posts or updates a corresponding job ad. This is driven by asynchronous lifecycle events as SEEK may not process the position sync in real time.When your software receives a Job Posting event and retrieves the corresponding PostedPositionProfile object from our GraphQL endpoint, correlate it to a position in your software via identifiers & references, then display it in your job ad list view. This improves hirer understanding and reduces the likelihood that they will inadvertently post a duplicate ad via classic or Enhanced Job Posting.An open position is not guaranteed to be automatically posted by Ad Sync. Hirers can specify rules to exclude certain positions, and data duplication or quality issues may prevent Ad Sync from advertising the position.

Posting sources

Your software must differentiate job ads that were automatically posted by Ad Sync from those that a hirer manually posted.This can be driven off of:

A posting source value stored by your software at the time of posting
The seekPostingSourceCode available when querying the state of a PostedPositionProfile

Include an (Ad Sync) qualifier in the channel or source field of your software. Your software may also support advanced sorting and filtering by this field.

Reference	Title	Source	Status	Created	Actions
AD-123	Señor business analyst	SEEK (Ad Sync)	Active	2048-01-01	…
…	…	…	…	…	…

If this is not feasible, your software may add an (Ad Sync) prefix to the title field of the job ad.

Reference	Title	Source	Status	Created	Actions
AD-123	(Ad Sync) Señor business analyst	SEEK	Active	2048-01-01	…
…	…	…	…	…	…

When querying the state of a PostedPositionProfile, your software will receive different seekCreatedBySelfIndicator and seekPostingSourceCode values depending on the posting source.

Ad Sync via SEEK APIAd Sync via feeds & web scrapingJob Posting via SEEK APISEEK Employer website

Copy

// Treat as automated posting

  "seekCreatedBySelfIndicator": true,

  "seekPostingSourceCode": "AdSync"

Lifecycle events

Subscribe to PositionProfileBlocked, PositionProfilePosted, PositionProfileUpdated, and PositionProfileClosed events to keep your software in sync. See our event documentation for more context.

PositionProfileBlocked

A job ad may be blocked before posting if it is deemed a duplicate of an existing ad under the same hirer account.Directional Provide an option to unblock the job ad via Enhanced Job Posting, once available.

Reference	Title	Source	Status	Created	Actions
AD-123	Señor business analyst	SEEK (Ad Sync)	Blocked	2048-01-01
…	…	…	…	…	…

PositionProfilePosted

Once a job ad has been posted, provide options to view the job ad on SEEK, and to manage the job ad via classic or Enhanced Job Posting. The latter allows hirers to further tailor the content of job ads posted via Ad Sync.

Reference	Title	Source	Status	Created	Actions
AD-123	Señor business analyst	SEEK (Ad Sync)	Active	2048-01-01
…	…	…	…	…	…

PositionProfileUpdated

Hirers can use the SEEK Employer website to edit job ads posted via Ad Sync. Keep the details in your software in sync with these changes.A new PostedPositionProfile.seekStatusCode field is available for your software to select. This will be Active while the job ad is listed on our employment marketplace.

Reference	Title	Source	Status	Created	Actions
AD-123	Senior business analyst	SEEK (Ad Sync)	Active	2048-01-01
…	…	…	…	…	…

In rare cases, SEEK may flag a job ad after it has been posted, move it to a Suspended status, and emit another PositionProfileUpdated event. This may be caused by duplicate job ads being posted under the same hirer account, or issues with the job ad content.Directional Your software may include a call to action for hirers to reactivate suspended job ads by contacting SEEK.

Reference	Title	Source	Status	Created	Actions
AD-123	Senior business analyst	SEEK (Ad Sync)	Suspended	2048-01-01	Contact SEEK
…	…	…	…	…	…

PositionProfileClosed

Expiration is a terminal state for the job ad. Disable the action to view it on SEEK.Directional Provide an option to re-post the job ad via Enhanced Job Posting, once available.

Reference	Title	Source	Status	Created	Actions
AD-123	Senior business analyst	SEEK (Ad Sync)	Expired	2048-01-01
…	…	…	…	…	…

Ad Sync: Share positions