This content is still in draft.
The SEEK API provides the ability for a hirer to preview a job ad as it would appear on SEEK.
By integrating job ad preview into your posting flow, hirers will be able to:
- Preview how their job ad will display in the SEEK search results and job details page.
- See how their job ad will look on desktop and mobile devices.
- Verify that their company logo and cover image is as expected.
- Spot issues with their job ad prior to posting, reducing the need to update their job ad later.
A job ad preview can be programmatically retrieved by your software when posting or updating a job ad.
This allows you to build your own button, write your own query to the SEEK API and choose how it is handled.
The Job Ad Preview page tracks our standard browser support policy.
- SEEK recommends using a browser token to generate a job ad preview directly from a hirer’s browser. For the browser token to work, you will need to include the
query:posted-position-profile-previewsscope in your request. - You can also generate a job ad preview URL for a hirer from your backend using a partner token.
Your implementation will need to:
- Display a button for hirers to click on to preview the job ad.The button should only be enabled if the hirer has provided a
positionTitle. - Execute the
postedPositionProfilePreviewquery to generate a job ad preview when the button is clicked.Your software must provide the state of the job ad to thepositionProfileargument . - With the
previewUrifield from the query response, open a new tab for the hirer or render an<iframe />in flow.The URI is valid for 24 hours.
QueryVariablesResult
CopyGraphQL Explorer
query ($positionProfile: PostedPositionProfilePreview_PositionProfileInput!) {
postedPositionProfilePreview(positionProfile: $positionProfile) {
previewUri {
url
}
}
}