Questionnaires

Questionnaires allow hirers to present a set of questions to candidates when they complete SEEK’s Apply Form. SEEK Optimised Apply enables the best candidate experience and conversion rates. Your software can ingest applications from SEEK, including questionnaire submissions and scoring.
1. Which of the following statements best describes your right to work in Australia?
2. Which of the following forklift licences do you have?
3. Do you even lift?
You may have opted out of questionnaire support with your initial SEEK API integration due to time constraints or because the implementation options available at the time were not suitable for your software. For example, the SEEK API first launched with ATS Screening Questions in 2020, but it wouldn’t have made sense to implement that option if your software did not have its own question library and questionnaire management capabilities. We have since developed new options like a SEEK-built Questionnaire Panel, so we encourage you to review what is available and factor questionnaire enhancements in to your product roadmap.The following table outlines our recommended next steps based on whether you have implemented a SEEK questionnaire option in your software.
Questionnaire Panel?
ATS Screening Questions?
Recommendation

Implementing SEEK questionnaires

The implementation option we recommend largely depends on whether your software has its own question library and questionnaire management capabilities:
Keep in mind that it will be intrinsically simpler for you to build advanced screening functionality when you control the question library. If your software supports applicant filtering and ranking based on questionnaire submissions, you may wish to consider ATS Screening Questions or linking out to an external apply form.

Option 1: Questionnaire Panel

We now offer a Questionnaire Panel that you can embed into your job posting workflow. Hirers can interact with the panel to author questionnaires using SEEK’s question library and recommendations.The Questionnaire Panel provides access to SEEK’s curated library of over 25,000 questions. Hirers may choose up to 8 library questions from a list of recommendations that are tailored to the position’s location, job category and title, and create up to 3 custom questions to capture niche or open-ended responses. SEEK questionnaires currently support free text, single select and multi select questions, and can be configured to require the acceptance of a privacy policy.You can preview a screenshot of the Questionnaire Panel below, and jump to the implementation guide to get started.
Questionnaire Panel screenshot

Option 2: ATS Screening Questions

If your software already has its own question library and questionnaire management capabilities, you can implement ATS Screening Questions.This option allows hirers to reuse the question capabilities in your software that they are already familiar with. Your software can then map the selected questions across to the SEEK API so they can be attached to job ads. SEEK questionnaires currently support free text, single select and multi select questions, as well as the acceptance of a privacy policy. You can nominate preferred responses for selection questions to drive scoring of candidate question submissions.Jump to the implementation guide to get started.

Uplifting the Questionnaire Panel

We have incorporated the Questionnaire Panel into our unified software development kit  alongside the new Ad Selection Panel. The new SDK makes it simpler for your software to embed multiple panels, and enables SEEK to safely enhance the panel over time with built-in support for beta testing and staged rollouts.

Render the panel

Adopt this change by including the new script tag on the webpage where the panel will be displayed:
HTML
Copy
<script
  type="text/javascript"
- src="https://seekcdn.com/hirer/indirect-posting/questionnaire-panel/SEEKQuestionnairePanel.js"
+ src="https://integration.seek.com/panels/SeekApi.js"
></script>
While its visual refresh will be noticeable, the new Questionnaire Panel also integrates with your software differently under the hood. Render via SeekApi.render:
JavaScript
Copy
- SEEKQuestionnairePanel.render(containerNode, options);
+ const { dispatchEvent } = SeekApi.render(containerNode, 'questionnaire', props);
The options supported are largely identical, but we have removed errorHandler as the SDK will display consistent and actionable error messages to the end user.The SEEK API will now tailor question recommendations to the location of the job ad and domicile of the SEEK hirer account. This enhancement works transparently without any additional partner effort.

Support Job Posting

The new dispatchEvent('seek:questionnaire:save') function call replaces the previous SEEKQuestionnairePanel.save() method.
BeforeAfter
Copy
const postSeekJobAd = async (input) => {
  // Call a posting mutation to post or update a SEEK job ad.
};

const handleSubmitButton = async () => {
  const input = {
    // Compose from form data.
  };

  const result = await SEEKQuestionnairePanel.save();

  if (result.errorCode) {
    // Do not post the job ad if an error occurs while saving the questionnaire.
    // The panel will display an error message to the hirer.
    return;
  }

  // Data will be nullish if the hirer did not add any questions via the panel.
  if (result.data?.id) {
    input.positionProfile.seekApplicationQuestionnaireId = result.data.id;
  }

  await postSeekJobAd(input);
};
The result from saving the questionnaire has been slightly tweaked, but it should be functionally equivalent:
Before
After
Description
data
data
Same behaviour as before
data.id
data.id
Same behaviour as before
errorCode
isError
Simplified to a boolean
Job ad drafts can continue to be supported in the same manner, with your software invoking dispatchEvent('seek:questionnaire:save') instead of SEEKQuestionnairePanel.save().