List all postings
The whole process begins when SmartRecruiters’ user submits a job to be published to your job board. In order to grab all the postings, use the below GET request:
curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/feed/publications
Response Body:
{ "Provider": "Smartrecruiters", "offset": "0", "limit": "100", "totalFound": "47", "jobs": [ { "id": "107099725", "uuid": "5f4727d2-0078-4099-b072-a81dba76a99e", "name": "Quality Assurance Manager", "refNumber": "REF328V", "status": "Pending", "jobAdUrl": "https://www.smartrecruiters.com/SmartRecruiters/12308096-quality-assurance-manager", "applyUrl": "https://www.smartrecruiters.com/Skechers1/12308096-quality-assurance-manager", "postedDate": "2015-10-02T00:20:08.000Z", "location": { "city": "Manhattan Beach", "region": "California", "regionCode": "CA", "country": "United States", "countryCode": "us", "longitude": "-118.41090889999998", "latitude": "33.8847361" }, "company": { "id": "12379433", "name": "SmartRecruiters" }, "creator": { "firstName": "John", "lastName": "Doe", "email": "johndoe@smartrecruiters.com" }, "compensation": {}, "industry": { "id": "retail", "label": "Retail" }, "function": { "id": "production", "label": "Production" }, "experienceLevel": { "id": "mid_senior_level", "label": "Mid-Senior Level" }, "typeOfEmployment": {}, "jobAd": { "companyDescription": "<p>Example company description with html tags</p>", "jobDescription": "<p>Example job description with html tags</p>", "qualifications": "<p>Example qualifications with html tags</p>", "additionalInformation": "<p>Example additional information with html tags</p>" } }, { "id": "107099726", "uuid": "0552caa6-96df-40c6-8c9d-642c7ef67a1c", "name": "Maintenance Mechanic", "refNumber": "REF27S", "status": "Pending", "jobAdUrl": "https://www.smartrecruiters.com/AcmeCorp/12300233-maintenance-mechanic", "applyUrl": "https://www.smartrecruiters.com/AcmeCorp/12300233-maintenance-mechanic", "postedDate": "2015-10-01T19:45:27.000Z", "location": { "city": "Fort Worth", "region": "Texas", "regionCode": "TX", "country": "United States", "countryCode": "us", "longitude": "-97.3307658", "latitude": "32.7554883" }, "company": { "id": "12387927", "name": "Acme Corp" }, "creator": { "firstName": "Jane", "lastName": "Doe", "email": "j.d@acmecorp.com" }, "compensation": {}, "industry": { "id": "food_production", "label": "Food Production" }, "function": { "id": "other", "label": "Other" }, "experienceLevel": { "id": "mid_senior_level", "label": "Mid-Senior Level" }, "typeOfEmployment": { "id": "permanent", "label": "Full-time" }, "jobAd": { "companyDescription": "<p>Example company description with html tags</p>", "jobDescription": "<p>Example job description with html tags</p>", "qualifications": "<p>Example qualifications with html tags</p>", "additionalInformation": "<p>Example additional information with html tags</p>" } } ] } |
List only new postings
To reduce the amount of data being pulled every time you call the endpoint, retrieve only new postings using the updatedAfter parameter:
curl -i -H "X-SmartToken: abc123" -X GET https://api.smartrecruiters.com/feed/publications?updatedAfter=2015-10-02T00:01:08.000Z
Response Body:
{ "Provider": "Smartrecruiters", "offset": "0", "limit": "100", "totalFound": "1", "jobs": [ { "id": "107099725", "uuid": "d43841a5-4263-4676-9cf0-2bf4257d4b6e", "name": "Quality Assurance Manager", "refNumber": "REF328V", "status": "Pending", "jobAdUrl": "https://www.smartrecruiters.com/SmartRecruiters/12308096-quality-assurance-manager", "applyUrl": "https://www.smartrecruiters.com/Skechers1/12308096-quality-assurance-manager", "postedDate": "2015-10-02T00:20:08.000Z", "location": { "city": "Manhattan Beach", "region": "California", "regionCode": "CA", "country": "United States", "countryCode": "us", "longitude": "-118.41090889999998", "latitude": "33.8847361" }, "company": { "id": "12379433", "name": "SmartRecruiters" }, "creator": { "firstName": "John", "lastName": "Doe", "email": "johndoe@smartrecruiters.com" }, "compensation": {}, "industry": { "id": "retail", "label": "Retail" }, "function": { "id": "production", "label": "Production" }, "experienceLevel": { "id": "mid_senior_level", "label": "Mid-Senior Level" }, "typeOfEmployment": {}, "jobAd": { "companyDescription": "<p>Example company description with html tags</p>", "jobDescription": "<p>Example job description with html tags</p>", "qualifications": "<p>Example qualifications with html tags</p>", "additionalInformation": "<p>Example additional information with html tags</p>" } } ] } |
You can find a full documentation of available endpoints in our Live Docs.