How to integrate SmartRecruiters jobs

Fetch SmartRecruiters jobs for free from their public posting API. Grab verified per-company feed URLs from our catalog — the same workflow as your other ATS integrations. Budget one detail request per job when you need full description text.

Company job feeds

5,740

Jobs

327,262

New feeds (30 days)

+18

Pull verified per-company feed URLs from our catalog — each entry gives you the {account} slug for GET /v1/companies/{account}/postings. You don't need to hunt employer identifiers yourself.

Paginate with limit and offset. Each content[] entry includes id, name, location, department, releasedDate, and a detail URL in ref.

When you need job description text, follow each posting's ref URL for the full PostingDetails payload — covered in the next section.

Side note: SmartRecruiters also publishes a public job sitemap if you prefer bulk discovery outside per-company feeds.

New to the catalog workflow? Start with Getting started.

Fetch jobs from the public API

Replace {account} with the company identifier from our catalog — the same value that appears at the end of the employer's SmartRecruiters career site URL.

Feed URL pattern
https://api.smartrecruiters.com/v1/companies/{account}/postings
Example list request
curl "https://api.smartrecruiters.com/v1/companies/{account}/postings?limit=100&offset=0"

Responses use a ListResult shape: content[], totalFound, limit, and offset. Walk pages until offset + limit >= totalFound. Maximum limit is 100. Each posting includes id, uuid, name, location, department, releasedDate, refNumber, and ref — but not jobAd description text.

Example list response (no descriptions)
{
  "offset": 0,
  "limit": 100,
  "totalFound": 250,
  "content": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Data Analyst",
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "ref": "https://api.smartrecruiters.com/v1/companies/acme/postings/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "location": {
        "city": "Paris",
        "country": "fr",
        "remote": false
      },
      "department": { "id": "dept-1", "label": "Analytics" },
      "releasedDate": "2026-02-20T10:00:00.000Z",
      "refNumber": "REF-1001"
    }
  ]
}

List API reference: SmartRecruiters postings list API.

Get job descriptions

Descriptions need a detail fetch

Two-step retrieval for descriptions: unlike Ashby, Greenhouse, Lever, Personio, and Recruitee — where one request per feed page returns full job data including description text — SmartRecruiters list responses include posting metadata but omit jobAd job descriptions, presumably to keep page sizes manageable. Budget one list request per feed page plus one detail request per job when descriptions matter.

GET {ref} once per posting from the list response. In practice, use the exact ref URL from each content[] entry — it points at .../postings/{id}.

Posting detail URL pattern
https://api.smartrecruiters.com/v1/companies/{account}/postings/{id}
Example detail request
curl "https://api.smartrecruiters.com/v1/companies/{account}/postings/744000001"

The detail response is PostingDetails: name for title, postingUrl for the public listing on jobs.smartrecruiters.com (fall back to ref when absent), releasedDate for posted date (RFC3339, nullable), and jobAd.sections for description HTML (e.g. jobDescription.text).

Example detail response
{
  "id": "744000001",
  "name": "Backend Engineer",
  "postingUrl": "https://jobs.smartrecruiters.com/Acme/744000001-backend-engineer",
  "releasedDate": "2026-06-01T10:00:00.000Z",
  "location": {
    "city": "Berlin",
    "country": "de",
    "remote": true
  },
  "department": { "id": "dept-1", "label": "Engineering" },
  "jobAd": {
    "sections": {
      "jobDescription": {
        "title": "Job description",
        "text": "<p>Build and scale our platform APIs.</p>"
      }
    }
  }
}

Detail API reference: SmartRecruiters posting detail API.

Pricing

Get the full SmartRecruiters feed catalog

Get access to 5,740 validated job feeds with 327,262 jobs on SmartRecruiters and other ATS platforms in our catalog via API or CSV export.

See pricingGetting started