In this article, you can learn how to create a new job post, delete an existing job post, retrieve job posts (including all available fields) and filter results to include expired or archived job posts or limit results by portal, department or corporation using the RecMan API.

Insert Job Post

POST

https://api.recman.io/v2/post/

To insert a job post, use the POST method with operation set to insert and scope set to jobPost.

It's required to specify projectId, name, startDate and endDate when inserting a job post. The response will include the new jobPostId.

POST URLhttps://api.recman.io/v2/post/
ScopejobPost
Operationinsert

Job Post Fields

FieldTypeDescription
projectId
required
integerProject ID
name
required
stringName
startDate
required
date-timeStart date. Format: Y-m-d H:i:s
endDate
required
date-timeEnd date. Format: Y-m-d H:i:s
accessionstringAccession (start date)
workplacestringWorkplace
bodystringBody (job description)
ingressstringIngress (company description)
titlestringTitle (job title)
numberOfPositionsintegerNumber of positions
deadlinestringApplication deadline
facebookstringFacebook
twitterstringTwitter
linkedinstringLinkedIn
webstringWebpage
address1stringAddress 1
address2stringAddress 2
postalCodestring or numericPostal code
citystringCity name
countrystringCountry name
salarystringSalary
applyUrlstringApply URL, must be a valid URL
branchIdintegerBranch ID (primary)
branchCategoryIdintegerBranch category ID (primary)
secondaryBranchIdintegerBranch ID (secondary)
secondaryBranchCategoryIdintegerBranch category ID (secondary)

Request Body

key{{api_key}}
scopejobPost
operationinsert
data.projectId236831
data.namePHP developer
data.startDate2024-10-10 00:00:00
data.endDate2024-12-10 00:00:00

Delete Job Post

POST

https://api.recman.io/v2/post/

To delete a job post, use the POST method with operation set to delete and scope set to jobPost.

It's required to specify the jobPostId field for deleting a job post.

URL POSThttps://api.recman.io/v2/post/
ScopejobPost
Operationdelete

Fields

FieldDescription
jobPostId
required
Job post ID

Request Body

key{{api_key}}
scopejobPost
operationdelete
data.jobPostId59575

Retrieve Job Posts

GET

https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields={{fields}}

By default, this request retrieves a list of all active job posts.

GET URLhttps://api.recman.io/v2/get/
ScopejobPost
FieldsSee list below
Examplehttps://api.recman.io/v2/get/?key=YOUR_KEY&scope=jobPost&fields=name,ingress,startDate,endDate

Job Post Fields

FieldTypeDescription
projectIdstringProject ID
applyUrlstringReturned by default. Can be overwritten by a self-defined URL on insert.
externalApplyUrlstringExternal apply link
namestringName
titlestringTitle
ingressstringIngress
bodystringBody
numberOfPositionsstringNumber of positions (also accepted as numPositions)
startDatestringStart date
endDatestringEnd date
logostringJob ad logo
deadlinestringDeadline date
departmentIdstringDepartment ID
facebook / linkedin / twitter / instagramstringSocial media URLs
address1 / address2stringAddress lines
postalCode / city / countrystringLocation details
webstringWebpage
salarystringSalary
corporationIdstringCorporation ID
created / updatedstringCreation / update timestamps
contactsstringContact persons
type / sector / accessionstringJob classification fields
companyNamestringCompany name
workplacestringWorkplace
imagesstringImages
videoUrlstringVideo URL
branchId / branchCategoryIdstringBranch ID and category (primary)
secondaryBranchId / secondaryBranchCategoryIdstringBranch ID and category (secondary)
skillsarray of stringsList of defined skills
countryId / regionId / cityIdintegerIDs of country, region and city
position / positionTypestringPosition and job type
socialMediaobjectSocial media details
finnUrlobjectFetches the Finn.no URL associated with the job post
locationsarrayArray of location objects
workLocationstringWork location: fromOffice, remote, or hybrid
employmentTypestringEmployment type: fullTime, partTime, or shiftwork
salaryInfoobjectStructure varies depending on the case:
Case 1: currency, amount, period
Case 2: currency, amount, toAmount, period
Case 3: custom

Include Expired or Archived Job Posts

By default, only active job posts are returned. To widen the result set, add one of the following parameters to the GET URL:

ParameterDescription
includeExpired=1Includes expired job posts in the result
includeArchived=1Includes archived job posts in the result

Example — Include expired

https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name&includeExpired=1

Example — Include archived

https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name&includeArchived=1

Limite Results by Portal

To retrieve only job posts published to a specific portal (for example Finn.no), add the portalId parameter.

https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name&portalId={{portalId}}

Note

The list below shows the portal name as the field and its corresponding portalId value as the description.

Portals

PortalportalId
RecMan Page1
Intranet2
finn.no3
nav.no4
dn.no5
jobbsafari.no6
jobbsafari.se7
jobindex.dk8
bygg.no9
ams.se (Old)10
monster11
skoljobb.se12
blocket.se13
workey.se14
jobreg.no15
Offshore16
Franchiseportalen17
hegnar.no18
Kapital19
Finansavisen20
Indeed21
Teknisk ukeblad22
oikotie.fi23
Graduate land24
Computer world25
Journalisten26
Medier2427
Fastighetsjobb28
Fastighetsvarlden29
jobbdirekt.se30
Samhallsbyggarjobb31
Byggvarlden32
Din Karriar33
DN. Din karriar34
Stepstone35
ams.se36
karriere.at37
derstandard.at38

Limite Results by Department or Corporation

Add the departmentId and/or corporationId parameter to the GET URL to limit results to a specific department or corporation.

https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name,departmentId,corporationId&
departmentId={{departmentId}}&corporationId={{corporationId}}

PARAMS

FieldDescription
key
required
{{api_key}}
scope
required
jobPost
fieldsname, departmentId, corporationId
departmentId{{departmentId}}
corporationId{{corporationId}}
Was this article helpful?
0 out of 0 found this helpful