In this article, you can read about how to retrieve job posts, including all available fields, and how to filter results to include expired or archived job posts, or to limit results by portal, department, or corporation.
Get 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 |
Including 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=1Limiting 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 |
Limiting 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}} |