Job

Job related methods

Get

Returns a specific job

https://api.itcareers.pl/job/get.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The requested job id (integer)
CURL example
$ curl --data "api_key=xxx&id=125378" https://api.itcareers.pl/job/get.json
Return values on success
{  
   "id":125378,
   "company":{  
      "id":2043,
      "name":"Bee Engineering - build together",
      "logo":"https:\/\/static.itcareers.pl\/images\/companies\/d7\/9c6\/2043\/logo.png",
      "description":"...",
      "phone":"213137691 ",
      "email":"[email protected]",
      "url":"http:\/\/www.bee-eng.pt",
      "slug":"bee-engineering-build-together"
   },
   "companyId":2043,
   "title":"Consultor Ruby on Rails",
   "body":"...",
   "ref":"",
   "salaryMin":11000,
   "salaryMax":17000,
   "types":[  
      {  
         "id":"1",
         "name":"Full Time"
      }
   ],
   "locations":[  
      {  
         "id":"14",
         "name":"Lisboa"
      }
   ],
   "country":"PT",
   "workModel":0,
   "publishedAt":"2015-06-23 10:28:33",
   "updatedAt":"2015-06-23 10:28:33",
   "slug":"consultor-ruby-on-rails"
}
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

List

Returns a list of jobs

https://api.itcareers.pl/job/list.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
limit No Number of results (integer)
page No Page number (integer)
company No Filter results by company (comma separated integers)
type No Filter results by type (comma separated integers)
contract No Filter results by contract (comma separated integers)
CURL example
$ curl --data "api_key=xxx&limit=2" \
      https://api.itcareers.pl/job/list.json
Return values on success
{  
   "total":2449,
   "page":1,
   "limit":2,
   "results":[  
      {  
         "id":127166,
         "company":{  
            "id":2328,
            "name":"AskBlue",
            "logo":"https:\/\/static.itcareers.pl\/images\/companies\/fd\/69d\/2328\/logo.png",
            "description":"...",
            "address":"Av. Estados Unidos da Am\u00e9rica, 102 - 7\u00ba E\r\n1700-179 Lisboa",
            "phone":"+(351) 217 960 456",
            "email":"[email protected]",
            "url":"http:\/\/www.askblue.pt",
            "slug":"askblue"
         },
         "companyId":2328,
         "title":" Programador C# e PHP",
         "body":"...",
         "ref":" #5689409",
         "salaryMin":11000,
         "salaryMax":17000,
         "workModel":0,
         "types":[  
            {  
               "id":"1",
               "name":"Full Time"
            }
         ],
         "locations":[  
            {  
               "id":"14",
               "name":"Lisboa"
            }
         ],
         "publishedAt":"2015-07-06 13:37:20",
         "updatedAt":"2015-07-06 13:37:20",
         "slug":"programador-c-e-php"
      },
      {  
         "id":127163,
         "company":{  
            "id":457,
            "name":"BABEL - Sistemas de Informa\u00e7\u00e3o",
            "logo":"https:\/\/static.itcareers.pl\/images\/companies\/42\/998\/457\/logo.png",
            "description":"...",
            "address":"Av. da Rep\u00fablica, 90\/96, Galeria \u2013 Frac\u00e7\u00e3o 3",
            "phone":217615810,
            "fax":217615819,
            "email":"[email protected]",
            "url":"http:\/\/www.babel.es",
            "slug":"babel-sistemas-de-informacao"
         },
         "companyId":457,
         "title":"Consultor Especialista em Usabilidade",
         "body":"...",
         "ref":"BABELPT15_ITJUsuab",
         "salaryMin":11000,
         "salaryMax":17000,
         "workModel":0,
         "types":[  
            {  
               "id":"1",
               "name":"Full Time"
            }
         ],
         "locations":[  
            {  
               "id":"14",
               "name":"Lisboa"
            }
         ],
         "publishedAt":"2015-07-06 13:37:03",
         "updatedAt":"2015-07-06 13:37:03",
         "slug":"consultor-especialista-em-usabilidade"
      }
   ]
}

Create

Creates a job ad on the site
This operation is reserved for companies registered/authorized on the site. Please refer to your own API KEYs.
This API call must use the HTTP POST method. 

https://api.itcareers.pl/job/create.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
title Yes Job title (string)
body Yes Job text (string)
location No Job location (comma separated integers)
contract No Job contract (comma separated integers)
type No Job type (comma separated integers)
workModel No Job work model: 0 (On-site), 1 (Remote), 2 (Hybrid). Defaults to 0 if omitted.
country No Job country (ISO 3166-1 alpha-2, e.g. PT, AO). Defaults to site country if omitted.
ref No Job reference (string)
salaryMin No Minimum annual gross salary (integer)
salaryMax No Maximum annual gross salary (integer)

The body parameter listed above should contain the text ad and can(should) use HTML to format it's layout.
The accepeted tags are 'p', 'strong', 'br', 'em', 'u', 'strike', 'ol', 'li', 'ul', 'a', 'b'. Tags attributes accepted are 'text-align'.
This API call must use the HTTP POST method.

CURL example
$ curl --data "api_key=xxx&title=Developer&body=<p>Your content</p>&ref=ITJ&location=1" https://api.itcareers.pl/job/create.json
Return values on success
{  
   "success":{  
      "message":"Job created successfully. You can check status at \/job\/status or your company dashboard.",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Not allowed. Please contact support."
   }
}

Edit

Edits a job ad on the site
This operation is reserved for companies registered on the site. Please refer to your own API KEYs 

https://api.itcareers.pl/job/edit.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
title No Job title (string)
body No Job text (string)
location No Job location (comma separated integers)
contract No Job contract (comma separated integers)
type No Job type (comma separated integers)
workModel No Job work model: 0 (On-site), 1 (Remote), 2 (Hybrid). Defaults to 0 if omitted.
country No Job country (ISO 3166-1 alpha-2, e.g. PT, AO). Defaults to site country if omitted.
ref No Job reference (string)
salaryMin No Minimum annual gross salary (integer)
salaryMax No Maximum annual gross salary (integer)

The body parameter listed above should contain the text ad and can(should) use HTML to format it's layout.
The accepeted tags are 'p', 'strong', 'br', 'em', 'u', 'strike', 'ol', 'li', 'ul', 'a', 'b'. Tags attributes accepted are 'text-align'.

CURL example
$ curl --data "api_key=xxx&id=127176&title=Developer&body=<p>Your content</p>&ref=ITJ&location=1" https://api.itcareers.pl/job/edit.json
Return values on success
{  
   "success":{  
      "message":"Job edited successfully. You can check status at \/job\/status or your company dashboard",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Not allowed. Please contact support."
   }
}

Status

Checks the status on a specific job ad
This operation is reserved for companies registered on the site. Please refer to your own API KEYs 

https://api.itcareers.pl/job/status.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
CURL example
$ curl --data "api_key=xxx&id=127176" https://api.itcareers.pl/job/status.json
Return values on success
{
    "success": {
        "status": {
            "id": "2",
            "name": "moderation"
        }
    }
}
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

Suspend

Suspends/removes a job ad on the site
This operation is reserved for companies registered on the site. Please refer to your own API KEYs 

https://api.itcareers.pl/job/suspend.json
Parameters
Parameter Required Description
api_key Yes Your unique identifier. You must request your API KEY. (string)
id Yes The job id (integer)
CURL example
$ curl --data "api_key=xxx&id=127176" https://api.itcareers.pl/job/suspend.json
Return values on success
{  
   "success":{  
      "message":"Job suspeded successfully. You can check status at /job/status or your company dashboard.",
      "id":"127176"
   }
}
Return values on error
{  
   "error":{  
      "message":"Job not found."
   }
}

Appendix

Information regarding Job state, type, contract, location and work model

State
Id Description
0Removed
1Active
2Moderation
3Suspended
4Refused
5Expired
Type
Id Description
1 Full-time
2 Part-time
Contract
Id Description
4 Freelance
3 Internship
1 Permanent
5 Temporary
2 Fixed term
Work model
Id Description
0On-Site
1Remote
2Hybrid
Location
Id Description
12 Białystok
3 Bydgoszcz
13 Gdańsk
9 Gorzów Wielkopolski
19 International
14 Katowice
16 Kielce
4 Kraków
7 Lublin
5 Łódź
17 Olsztyn
11 Opole
1 Poznań
15 Rzeszów
18 Szczecin
2 Toruń
10 Warszawa
6 Wrocław
8 Zielona Góra