With the consolidation of the SEEK, Jobstreet and Jobsdb platforms, we have changed the way job ads are surfaced across our markets.
Your job posting integration must be revised to ensure that it correctly interoperates with the SEEK API going forward.
Job ads posted via the SEEK API are syndicated across our candidate websites,
including seek.com.au , seek.co.nz , jobstreet.com and jobsdb.com .
Each website defaults to a market-specific location filter but candidates are able to manually search for international job ads.
When your software retrieves the
positionUri field in response to a PositionProfilePosted event,
it will receive a localised link to the live job ad.
This is based on the hirer’s country as configured in SEEK;
a hirer based in Singapore is assigned a jobstreet.com.sg link,
while a hirer based in Australia continues to be assigned a seek.com.au link.We have extended the following job posting features to satisfy regional requirements across the Asia Pacific.
The revision is required even if you do not offer your recruitment software in these additional markets,
as it includes changes to marketplace features that affect Australia & New Zealand hirers.
Market | Features | Detail |
|---|---|---|
ANZ | Ad Selection Revision | |
ANZ | Job Ad Preview / Branding |
|
Asia | Access to Asia features (Optional) |
Before you commence your integration, please ensure that:
- Your user experience is in line with our job posting user experience guide, and if implementing ad selection via GraphQL, adheres to ourad selection user experience guide.
- You have access to the SEEK test hirer provided for development and testing purposes. Test hirers can post job ads free of charge, but their job ads don’t appear in SEEK’s search results.
If you require any technical support during your integration please contact our Integration Service Desk , available Monday - Friday 9:00AM to 5:00PM AEST.
The checklist below outlines best practices for integrating each job posting feature:
If you have already built a supported implementation option in your software you may skip this step.
If your software maintains a static mapping from its internal location hierarchy to SEEK location IDs:
- Review available options within our Location documentation
- Implement API option most appropriate to your software
- Remove static mapping
If your software already supports SEEK’s dynamic job categories, you can skip this step.
This change ensures that hirers are only presented with relevant categories and that those categories are matched to the region the job is being posted in.
- Call the jobCategories query dynamically for each job ad, passing the current state of the ad in the
positionProfilefield - Ensure that all
categories / sub-categoriesreturned are visible and sub-categories are selectable by the hirer
- Remove deprecated
CommissionOnlypay type - Remove any hard coded validation values (such as limiting max salary to a fixed value)
- Implement error display for salary values as defined in our Salary validation documentation
- Implement recommended UX updates for Salary Range
SEEK strongly recommends using the new Ad Selection 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.
Ad Selection now requires the use of
seekAdvertisementProductId. Using the deprecated seekAnzAdvertisementType will result in failed Job Posting create and update calls following the December 2024 retirement date.- Review available options within our Ad Selection documentation
- If migrating from the previous Ad Selection Panel:
- Update script tag and render function with revised props
- Call render function on page load and when changes to
positionProfileinput are made - Replace any hard coded logic for brand selection / bullet point inputs with conditional logic based on features returned in
onChange - Replace references to
seekAnzAdvertisementTypewithseekAdvertisementProductIdfield when previewing, posting or updating the job ad
- If using GraphQL integration:
- Review the user experience guide and ensure that your implementation will meet our new requirements
- Rebuild calls to use the new
advertisementProductsquery - Call query on page load and whenever the positionProfile input changes
- Adjust UI to handle a variable number of products (we recommend accommodating 4) or provide a
limitparam - Ensure your UI pre-selects the ad product marked with
selectedif one exists (typically returned when updating a job ad or when usingselectedAdvertisementProductIdfor rehydrating a draft) - Remove any hardcoded logic based on specific names or identifiers
- Replace references to
seekAnzAdvertisementTypewithseekAdvertisementProductIdfield when previewing, posting or updating the job ad
- Display selectable branding elements to hirer retrieved from Brandings query
- Pass selected branding ID as part of
positionProfilein preview, create and update calls - Ensure correct branding is displayed as selected during ad edit
- Display branding selection based on ad product features
Note that the SEEK API does not allow Questionnaire’s to be modified once a job ad is posted. See the questionnaire immutability documentation for more information.
- Review available options within our Questionnaire documentation
- If you have previously implemented the SEEK Questionnaire Panel:
- Update script tag and render function call
- Remove any references to
errorHandler - Update calls from
SEEKQuestionnairePanel.save() to dispatchEvent('seek:questionnaire:save'); - Update handling of errorCode / isError
- If you’re implementing the SEEK Questionnaire Panel for the first time:
- Add script tag to the page
- Call render function on page load and when changes to
positionProfileinput are made - Handle browser token request
- Call
dispatchEvent('seek:questionnaire:save')prior to previewing, posting or saving a draft of the job ad
- If you have an existing question library and are implementing our ATS Screening Questions functionality:
- Implement the
createApplicationQuestionnairemutation - Post job ad with returned questionnaire ID
If you have already built job ad preview then skip this step. However, you should review two other changes to the
postedPositionProfilePreview query for Ad Selection and Questionnaire.- Display a button for hirers to click on to preview the job ad
- Execute the
postedPositionProfilePreviewquery to generate a job ad preview when the button is clicked - Ensure the full state of the ad is passed to the positionProfile argument
- Open new tab or render iframe in the flow to the returned
previewUrifield
If you have customers in Asia or customers in ANZ wishing to post ads in Asia, you can enable job posting in our six Asia markets by supporting localised salaries and content.
- Implement the
Monthly pay interval - Display a shortlist of currencies for hirers to select
- We recommend retrieving the shortlist of currencies from our currencies query to support further updates.
- Pre-select the recommended currency based on job location
- Send an appropriate
Accept-Languageheader in GraphQL requests
Before you apply for SEEK Certification, thoroughly test your integration for the successful execution of the following:
- Job ad previewed successfully
- Display of location and ad product features
- Display of questionnaire (if implemented)
- Successful posting of a job ad
- Location passed through successfully
- Ad Product passed through successfully
- Questionnaire posted successfully (if implemented)
- Job ad posted for maximum period (30 days)
- Successful updating of a job ad
- Location passed through successfully
- Correct Edit/Upgrade Ad Product passed through successfully
- Successful closing of a job ad
- Job ad closed on-demand prior to 30 days
To ensure the features are built correctly, we’ve created four certification groups listed in the downloadable Excel workbook below.
It includes all the test cases necessary for certification:
- Group 1: Ad Selection Revision
- Group 2: Job Ad Preview and Brand Selection
- Group 3: Access to Asia markets (if implemented)
- Group 4: Managing a Job Ad
- Ensure completion of all relevant test cases for the features you have implemented
- Record 4 videos to showcase and talk us through the test cases for each certification group
- Submit these videos with your certification request to the Integration Service Desk
Please note:
- Certification will only be given by SEEK if we receive complete coverage of the test cases in your video submissions
- SEEK will notify you if it identifies any issues with your integration
- All issues must be resolved in order to obtain successful certification and prior to live deployment
- For further review after making corrections, resubmit a new video to the Integration Service Desk
When submitting your certification request, include:
- Your anticipated integration release date
- The date you began recording the test case videos
- Links to the test case videos
- URL for the test job ad posted to
www.seek.com.au(this will appear as expired after completion of the test cases) - URL for the test job ad posted to
www.jobstreet.com.my(this will appear as expired after completion of the test cases)
- Each video should not exceed 10 minutes
- The video file must be downloadable
- The video file format should be mp4 video format
- The file name must follow this format:
Partner Name_JP_CertGroup.mp4
Upon receiving your certification submission, SEEK will provide you with instructions to prepare for your integration release.