Job ads are represented in the SEEK API by
PositionProfile
objects.
The position’s profile consists of:- Information on how to present the position opening to a candidate including its title, description and salary.
- The location and job category of the position. These are displayed to the candidate and help determine the job ad’s price.
- Posting instructions including the SEEK ad product and application method.
PositionProfile
data to one of the posting mutations.
This starts an asynchronous process to place a live job ad on the SEEK job board.The majority of job ads are automatically posted within a minute.
However, in certain circumstances SEEK will manually review a job ad before it’s posted.
In either case, a PositionProfilePosted
event will be emitted immediately after the job ad goes live.The job ad will automatically close on its scheduled end
date.
If an end date wasn’t specified during posting it will default to the maximum period of 30 days.
Scheduled closure is not instantaneous, and typically occurs within 24 hours.You can explicitly close a job ad earlier using the closePostedPositionProfile
mutation.
Once the job ad is closed it will be removed from the SEEK job board and a PositionProfileClosed
event will be emitted.SEEK job ads are priced for a fixed time period of 30 days.
You can close a job ad earlier but the SEEK hirer will still be charged full price.The PositionProfile
object and its associated candidate applications will remain for 180 days after its close date.
Your software must store any data it needs to access after the 180 day period.Before you can start with job posting queries and mutations, you will need to request a partner token.You can interact with PositionProfile
objects by:- Posting a job ad using a
PositionProfile
input - Querying a job ad to retrieve the
PositionProfile
’s data - Updating a job ad using a
PositionProfile
input and an existing job ad’sprofileId