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.
You can post a job ad by passing
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
PositionProfileinput - Querying a job ad to retrieve the
PositionProfile’s data - Updating a job ad using a
PositionProfileinput and an existing job ad’sprofileId