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 URL | https://api.recman.io/v2/post/ |
| Scope | jobPost |
| Operation | insert |
Job Post Fields
| Field | Type | Description |
|---|---|---|
| projectId required | integer | Project ID |
| name required | string | Name |
| startDate required | date-time | Start date. Format: Y-m-d H:i:s |
| endDate required | date-time | End date. Format: Y-m-d H:i:s |
| accession | string | Accession (start date) |
| workplace | string | Workplace |
| body | string | Body (job description) |
| ingress | string | Ingress (company description) |
| title | string | Title (job title) |
| numberOfPositions | integer | Number of positions |
| deadline | string | Application deadline |
| string | ||
| string | ||
| string | ||
| web | string | Webpage |
| address1 | string | Address 1 |
| address2 | string | Address 2 |
| postalCode | string or numeric | Postal code |
| city | string | City name |
| country | string | Country name |
| salary | string | Salary |
| applyUrl | string | Apply URL, must be a valid URL |
| branchId | integer | Branch ID (primary) |
| branchCategoryId | integer | Branch category ID (primary) |
| secondaryBranchId | integer | Branch ID (secondary) |
| secondaryBranchCategoryId | integer | Branch category ID (secondary) |
Request Body
| key | {{api_key}} |
| scope | jobPost |
| operation | insert |
| data.projectId | 236831 |
| data.name | PHP developer |
| data.startDate | 2024-10-10 00:00:00 |
| data.endDate | 2024-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 POST | https://api.recman.io/v2/post/ |
| Scope | jobPost |
| Operation | delete |
Fields
| Field | Description |
|---|---|
| jobPostId required | Job post ID |
Request Body
| key | {{api_key}} |
| scope | jobPost |
| operation | delete |
| data.jobPostId | 59575 |
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 URL | https://api.recman.io/v2/get/ |
| Scope | jobPost |
| Fields | See list below |
| Example | https://api.recman.io/v2/get/?key=YOUR_KEY&scope=jobPost&fields=name,ingress,startDate,endDate |
Job Post Fields
| Field | Type | Description |
|---|---|---|
| projectId | string | Project ID |
| applyUrl | string | Returned by default. Can be overwritten by a self-defined URL on insert. |
| externalApplyUrl | string | External apply link |
| name | string | Name |
| title | string | Title |
| ingress | string | Ingress |
| body | string | Body |
| numberOfPositions | string | Number of positions (also accepted as numPositions) |
| startDate | string | Start date |
| endDate | string | End date |
| logo | string | Job ad logo |
| deadline | string | Deadline date |
| departmentId | string | Department ID |
| facebook / linkedin / twitter / instagram | string | Social media URLs |
| address1 / address2 | string | Address lines |
| postalCode / city / country | string | Location details |
| web | string | Webpage |
| salary | string | Salary |
| corporationId | string | Corporation ID |
| created / updated | string | Creation / update timestamps |
| contacts | string | Contact persons |
| type / sector / accession | string | Job classification fields |
| companyName | string | Company name |
| workplace | string | Workplace |
| images | string | Images |
| videoUrl | string | Video URL |
| branchId / branchCategoryId | string | Branch ID and category (primary) |
| secondaryBranchId / secondaryBranchCategoryId | string | Branch ID and category (secondary) |
| skills | array of strings | List of defined skills |
| countryId / regionId / cityId | integer | IDs of country, region and city |
| position / positionType | string | Position and job type |
| socialMedia | object | Social media details |
| finnUrl | object | Fetches the Finn.no URL associated with the job post |
| locations | array | Array of location objects |
| workLocation | string | Work location: fromOffice, remote, or hybrid |
| employmentType | string | Employment type: fullTime, partTime, or shiftwork |
| salaryInfo | object | Structure 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:
| Parameter | Description |
|---|---|
| includeExpired=1 | Includes expired job posts in the result |
| includeArchived=1 | Includes archived job posts in the result |
Example — Include expired
https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name&includeExpired=1Example — Include archived
https://api.recman.io/v2/get/?key={{api_key}}&scope=
jobPost&fields=name&includeArchived=1Limite 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
| Portal | portalId |
|---|---|
| RecMan Page | 1 |
| Intranet | 2 |
| finn.no | 3 |
| nav.no | 4 |
| dn.no | 5 |
| jobbsafari.no | 6 |
| jobbsafari.se | 7 |
| jobindex.dk | 8 |
| bygg.no | 9 |
| ams.se (Old) | 10 |
| monster | 11 |
| skoljobb.se | 12 |
| blocket.se | 13 |
| workey.se | 14 |
| jobreg.no | 15 |
| Offshore | 16 |
| Franchiseportalen | 17 |
| hegnar.no | 18 |
| Kapital | 19 |
| Finansavisen | 20 |
| Indeed | 21 |
| Teknisk ukeblad | 22 |
| oikotie.fi | 23 |
| Graduate land | 24 |
| Computer world | 25 |
| Journalisten | 26 |
| Medier24 | 27 |
| Fastighetsjobb | 28 |
| Fastighetsvarlden | 29 |
| jobbdirekt.se | 30 |
| Samhallsbyggarjobb | 31 |
| Byggvarlden | 32 |
| Din Karriar | 33 |
| DN. Din karriar | 34 |
| Stepstone | 35 |
| ams.se | 36 |
| karriere.at | 37 |
| derstandard.at | 38 |
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
| Field | Description |
|---|---|
| key required | {{api_key}} |
| scope required | jobPost |
| fields | name, departmentId, corporationId |
| departmentId | {{departmentId}} |
| corporationId | {{corporationId}} |