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.
- 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-previews
scope 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
postedPositionProfilePreview
query to generate a job ad preview when the button is clicked.Your software must provide the state of the job ad to thepositionProfile
argument . - With the
previewUri
field 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
Copy GraphQL Explorer
query ($positionProfile: PostedPositionProfilePreview_PositionProfileInput!) {
postedPositionProfilePreview(positionProfile: $positionProfile) {
previewUri {
url
}
}
}