Managing job ads

Managing job ads

Job ads are represented in the SEEK API by PositionProfile objects.
PositionOpeningPositionProfilePostingRequesterPostingInstructionsJobCategoryLocationcontainsspecifiesspecifiesspecifiesspecifies
The position’s profile consists of:

Job ad lifecycle

less than a minute
180 days
Posting mutation
Job ad goes live
PositionProfilePosted event fired
End date reached
closePostedPositionProfile mutation
Job ad is removed
PositionProfile is deleted
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. Posting typically takes less than a minute after which a PositionProfilePosted event will be generated.
The job ad will remain live until the end date specified in the posting instructions. You can also explicitly close it earlier using the closePostedPositionProfile mutation . Once the job ad is closed it will be removed from the SEEK job board.
In SEEK Australia & New Zealand 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 begin

Before you can start with job posting query and mutations, you will need to request a partner token.

Operations

You can interact with PositionProfile objects by:
  • Posting a job ad using a PositionProfile input.
  • Updating a job ad using a PositionProfile with profileId input.
  • Querying PositionProfile data
  • Closing a job ad
Managing job ads
Managing job ads