/postings

Description

Lists active postings published by given company.

Request

GET https://api.smartrecruiters.com/v1/companies/{companyIdentifier}/postings?q={query}&limit={limit}&offset={offset}&country={country}&region={region}&city={city}&department={department}&custom_field.{customFieldId}={customFieldValueId}&language={language}

Path Parameters

name type description
companyIdentifier string The company id as it appears at the end of your default career site.  To find have an administrator go to “Settings/Admin” and click on “Career Pages & Job Ads” and it will be what appears after the / in  “https://careers.smartrecruiters.com/”

Query Parameters

name type description
limit integer number of elements to return. max value is 100
offset integer number of elements to skip while processing result
country string country code filter (part of the location object)
region string region filter (part of the location object)
city string city filter (part of the location object)
department string department filter (department id)
customFieldId string customField filter (field id; part of the customField object); works together with customFieldValueId; e.g. custom_field.52d95747e4b0ba7acb9217ea=23aba1d4-4c81-48f7-9ae2-3ab84ee32a80
customFieldValueId string customField value (value id; part of the customField object). Multiple value ids can be provided, separated by comma (“,”)
q string full-text search query based on a job title, location.
language string job ad language; accepts 2-letter ISO 639-1 language code; multiple codes can be provided, separated by comma (“,”)
Exceptions to the language code ISO format:

  • “en-GB” – “English – English (UK)”
  • “fr-CA” – “French – français (Canada)”
  • “pt-BR” – “Portugal – português (Brasil)”
  • “pt-PT” – “Portugal – português (Portugal)”
  • “zh-HK” – “Chinese (Traditional) – 中文 (香港)”
  • “zh-CN” – “Chinese (Simplified) – 中文 (简体)”

Request Body

n/a

Response Body

ListResult containing list of Posting objects. However, some fields might not be set. To get full object use ‘ref’ property.

Example request

curl -i  https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings?offset=10&q=developer

Example response

{
    "limit": 10,
    "offset": 0,
    "totalFound": 2,
    "content": [ 
        {
        "id": "74983486",
        "name": "test job",
        "company": {
            "identifier": "smartrecruiters",
            "name": "SmartRecruiters"
        },
        "releasedDate": "2011-12-19T15:28:46.493Z",
        "location": {
             "country": "US", 
             "region": "FL",
             "city": "Orlando" 
        },  
        "industry": {
            "id": "computer_software",
            "label": "Computer Software"
        },
        "department": {
            "id": 2323,            
            "label": "IT",
            "description": "IT Department"   
        },        
        "function": {
            "id": "engineering",
            "label": "Engineering"
        },
        "typeOfEmployment": {
            "id": "prop_toe_perm",
            "label": "Permanent"
        },
        "experienceLevel": {
            "id": "mid_senior_level",
            "label": "senior"
        },     
        "customField": [
            {
                "fieldId": "52d3c1b32c613b40c5797627",
                "fieldLabel": "Division",
                "valueId": "4b5716a0-9095-4caa-b583-3b03c8ded8c0",
                "valueLabel": "Sales EMEA"
            }
        ],
        "ref": "https://api.smartrecruiters.com/api-v1/companies/smartrecruiters/postings/74983486",
        "creator": {
            "name": "John Doe",
        }
    },
    {
        "id": "74790901",
        "name": "Account Manager",
        "company": {
            "identifier": "smartrecruiters",
            "name": "SmartRecruiters Inc"
        },
        "releasedDate": "2013-12-19T18:34:21.443Z",
        "location": {
            "city": "San Francisco",
            "region": "CA",
            "country": "us"
        },
        "industry": {
            "id": "computer_software",
            "label": "Computer Software"        },
        "department": {
            "id": 2323,            
            "label": "Finance",
            "description": "Finance Department"
        },
        "function": {
            "id": "engineering",
            "label": "Engineering"
        },
        "typeOfEmployment": {
            "id": "toe_perm",
            "label": "Permanent"
        },
        "experienceLevel": {
            "id": "mid_senior_level",
            "label": "senior"
        },
        "customField": [
            {
                "fieldId": "52d3c1b32c613b40c5797627",
                "fieldLabel": "Division",
                "valueId": "32c87a5d-1365-4dc3-80fe-ecacfb0799c7",
                "valueLabel": "Marketing US"                
            }
        ],
        "ref": "https://api.smartrecruiters.com/api-v1/companies/smartrecruiters/postings/876737562",
        "creator": {
            "name": "John Doe"
        }
    }
]
}

Example requests (executable)

https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings/
https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings/?q=Front%20End
https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings/?offset=2&limit=2
https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings/?city=San%20Francisco