Description
Method that allows searching for jobs in a company.
Request
GET https://api.smartrecruiters.com/jobs?q={query}&limit={limit}&offset={offset}&city={city}&department={department}
Path Parameters
n/a
Query Parameters
name | type | description |
---|---|---|
q | string | full-text search query based on a job title; case insensitive; e.g. java developer |
limit | integer | number of elements to return. max value is 100, default is 10 |
offset | integer | number of elements to skip while processing result; e.g. 10 |
city | string | city filter (part of the location object); can be used repeatedly; case insensitive; e.g. San Francisco; part of the Location obejct |
department | integer | department name filter; can be used repeatedly; case insensitive; e.g. “Engineering”; part of the Department obejct |
All parameters which can be used repeatedly should follow the below notation example:
curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/jobs?department=1234&department=4567
Request Body
n/a
Response Body
ListResult containing list of Job List objects. However, some fields might not be set. To get full object use ‘details’ property.
Example request
curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/jobs?q=Java%20Developer&limit=10
Example response
{ "totalFound": 2, "offset": 0, "limit": 10, "content": [ { "id": "63f13acf-9d74-46db-9178-c47310a8b7bc", "title": "Java Developer", "refNumber": "REF914A", "createdOn": "2014-10-08T17:04:07.000Z", "department": { "label": "Development" }, "location": { "country": "Yemen", "countryCode": "ye", "city": "Sana'a", "longitude": 41.40338, "latitude": 2.17403 }, "actions": { "details": { "url": "https://api-int.smartrecruiters.com/jobs/63f13acf-9d74-46db-9178-c47310a8b7bc", "method": "GET" } } }, { "id": "77650100-0245-9090-6022-680719216822", "title": "Java Developer", "refNumber": "REF60G", "createdOn": "2009-02-17T13:54:12.000Z", "department": { "label": "R&D" }, "location": { "country": "United States", "countryCode": "us", "regionCode": "FL", "city": "Hollywood" "longitude": 3.32148, "latitude": 30.12345 }, "actions": { "details": { "url": "https://api-int.smartrecruiters.com/jobs/77650100-0245-9090-6022-680719216822", "method": "GET" } } } ] } |