Get job postings

List all postings

The whole process begins when a user of SmartRecruiters’ BackOffice 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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
{
    "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=015-10-02T00:01:08.000Z

Response Body:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
{
    "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.