/jobs – list

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