This content is still in draft.
A job ad may specify a questionnaire to include in SEEK’s native application form. Candidates complete the questionnaire as part of their job application, and their responses are made available through the Application Export use case. Questionnaires are rendered on SEEK’s candidate website and in our mobile apps.
By integrating questionnaires into your posting flow, you can enable hirers to:
- View and select question suggestions from SEEK’s library of commonly used and relevant questions.
- Add custom questions if they do not find the questions in SEEK’s existing library to be relevant.
- Select preferred response choices for each selected question.
ApplicationQuestionnaireis represented as an immutable collection of components.
ApplicationQuestionallows the hirer to ask a screening question:
FreeTextpresents the candidate with a free text input labelled with the question’s
questionHtml. They must input at least one character before submitting their application.
SingleSelectpresents the candidate with a set of mutually exclusive choices. They must select a single choice before submitting their application.SEEK renders these questions either as radio buttons or a dropdown list, depending on the number of choices.
MultiSelectpresents the candidate with a set of non-exclusive choices. They must select at least one choice before submitting their application.SEEK renders these questions as a list of checkboxes.
MultiSelectquestions may be suggested from SEEK’s library via the
applicationQuestionSuggestionsquery or created as custom by the hirer during the job posting flow.
A candidate’s questionnaire submission can be retrieved through the Application Export use case. The submission can be correlated back to the presented questionnaire and its individual components.
The SEEK API can optionally calculate a numeric score for each questionnaire submission. This requires that your software indicates which response choices are preferred by the hirer. The calculated score and preference indicators are not otherwise used by SEEK.
ApplicationQuestionspecifies a collection of possible choices through the
ApplicationQuestionChoicecan be preferenced by setting its
preferredIndicatorduring questionnaire creation. Candidate responses are scored against these preferred choices.
These scores are provided as an advisory screening indicator for the hirer. All candidate applications will be delivered to your software; SEEK does not support knockout questions and does not reject applications based on score.
The SEEK API imposes the following limits on questionnaires:
- 100 total components
- 99 response choices for
Lengthy application forms deter candidates from applying, so we encourage hirers to keep their questionnaires short and focussed.
For an equitable screening process, a SEEK job ad presents the same questionnaire to all applicants. This is enforced in two ways:
The SEEK API supports multiple options for implementing questionnaires.
SEEK offers a Questionnaire Panel that you can embed into your posting flow.
SEEK strongly recommends using the Questionnaire Panel for your integration. It will significantly reduce development time and ongoing maintenance, as well as provide an up-to-date user experience for SEEK hirers.
Jump to the panel section to get started.
The SEEK Questionnaire Panel is built on operations available through our GraphQL endpoint. You can programmatically retrieve recommended questions, define custom questions and privacy policies, and create questionnaires. This allows you to build your own custom user interface for questionnaires.
Jump to the custom panel section to get started.
If your software already has a mechanism for creating and managing questions, you can reuse them by internally mapping to the SEEK API’s questionnaire structure.
Jump to the ATS questions section to get started.