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}®ion={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:
|
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", "uuid": "34225731-e7cf-4584-b0b7-78098fe1a66b", "name": "test job", "jobAdId": "106f35bc-a0e6-4e55-96f9-56835e3f8349", "company": { "identifier": "smartrecruiters", "name": "SmartRecruiters" }, "releasedDate": "2011-12-19T15:28:46.493Z", "location": { "country": "US", "region": "FL", "city": "Orlando", "remote": false "latitude": "28.557071", "longitude": "-81.359463" }, "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", "uuid": "45425731-e7cf-4584-a0a7-78098fe1a58a", "name": "Account Manager", "company": { "identifier": "smartrecruiters", "name": "SmartRecruiters Inc" }, "releasedDate": "2013-12-19T18:34:21.443Z", "location": { "city": "San Francisco", "region": "CA", "country": "us", "remote": true }, "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