Previewing a job ad

    Suggestions will appear below the field as you type

    Previewing a job ad

      Suggestions will appear below the field as you type

      Previewing a job ad

      Previewing a job ad

      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.

      Before you begin

      • 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.

      Building job ad preview

      Your implementation will need to:
      1. 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.
      2. 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 the positionProfile argument .
      3. 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.

      Example query

      QueryVariablesResult
      query ($positionProfile: PostedPositionProfilePreview_PositionProfileInput!) {
        postedPositionProfilePreview(positionProfile: $positionProfile) {
          previewUri {
            url
          }
        }
      }