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"
}
}
}
]
} |