Get job postings
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": {
"cid": "5ffeacd689ced0227c3447a9",
"name": "SmartRecruiters",
"identifier": "smartrecruiters"
},
"creator": {
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]"
},
"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": {
"cid": "5ffead3128a14a06784fbf66",
"name": "Acme Corp",
"identifier": "acmeCorp"
},
"creator": {
"firstName": "Jane",
"lastName": "Doe",
"email": "[email protected]"
},
"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": {
"cid": "5ffeacd689ced0227c3447a9",
"name": "SmartrecRuiters",
"identifier": "smartrecruiters"
},
"creator": {
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]"
},
"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.
Updated over 2 years ago