# SmartRecruiters Jobs API & Scraper: Any Company, Only New (`sandy_cornfield/smartrecruiters-jobs-api`) Actor

Get every open job from any company's SmartRecruiters site as clean JSON: title, department, employment type, experience level, locations, remote/hybrid, posted date, apply link, even for boards with thousands of jobs. Paste a careers page, a SmartRecruiters URL or a company name. Only-new mode.

- **URL**: https://apify.com/sandy_cornfield/smartrecruiters-jobs-api.md
- **Developed by:** [Careers Data Lab](https://apify.com/sandy_cornfield) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SmartRecruiters Jobs API & Scraper

Get every open job from any company that hires with SmartRecruiters, straight from its SmartRecruiters job board, in one clean JSON format.

The Actor reads SmartRecruiters's **public job-board feed**, the same one that powers the company's careers page. No browser, no proxies, no login: a board with hundreds of jobs comes back in seconds, and nothing breaks when the careers page changes its design.

### What you get

- **Any SmartRecruiters company.** Enter the company name, its SmartRecruiters board URL, one job link, or just the company's own careers page: the Actor finds the SmartRecruiters board behind it.
- **Clean, consistent fields.** Title, department, team, employment type, all locations, workplace type (remote / hybrid / onsite), posted and updated dates in UTC, job page and apply links, salary when the employer publishes it.
- **Only new jobs.** Switch on *Only new jobs since the last run* and schedule the Actor: each run returns only postings you have not received before. Ideal for job alerts, newsletters and lead lists.
- **Filters.** Title keywords, excluded keywords, locations, workplace types, "posted in the last N days", a total cap and a per-company cap.
- **Full descriptions (optional)** as plain text, with free keyword flags for visa sponsorship and relocation.
- **AI fields (optional, charged separately):** visa sponsorship yes/no/unknown *with the exact quote*, relocation support, remote regions, normalised salary range and period, seniority, minimum years of experience, skills and required languages. A failed enrichment is never charged.

### Input

| Field | Example |
|---|---|
| Companies | `Ubisoft2`, `https://jobs.smartrecruiters.com/Wise`, `https://careers.smartrecruiters.com/BoschGroup` |
| Title keywords | `engineer`, `sales` |
| Locations | `London`, `New York`, `Remote` |
| Workplace types | `remote`, `hybrid` |
| Posted within (days) | `7` |

A plain company name is looked up on SmartRecruiters only. Links to the other ATS this Actor reads (Greenhouse, Lever, Ashby, SmartRecruiters, Recruitee, Workable, Personio, Teamtailor, Gem, Breezy HR) work too, so one run can mix them.

#### Finding a company's SmartRecruiters board

Open one job on the company's careers page. If the link goes to `jobs.smartrecruiters.com/<name>`, that name is the company identifier (`BoschGroup`, `Wise`, `Ubisoft2`); it is not always the plain company name, so copy it from the link. Boards look like `jobs.smartrecruiters.com/<company>` or `careers.smartrecruiters.com/<company>`.

### Output (one item per job)

A real item from a live SmartRecruiters board:

```json
{
  "id": "smartrecruiters:ubisoft2:744000161884795",
  "ats": "smartrecruiters",
  "companySlug": "Ubisoft2",
  "companyName": "Ubisoft",
  "title": "LookDev Artist - Hybride VFX",
  "department": "Ubisoft",
  "team": null,
  "employmentType": "Full-time",
  "seniority": "Mid-Senior Level",
  "locations": [
    "Montreal, QC, Canada"
  ],
  "workplaceType": "hybrid",
  "postedAt": "2026-11-16T18:21:56Z",
  "updatedAt": null,
  "url": "https://jobs.smartrecruiters.com/Ubisoft2/744000161884795",
  "applyUrl": "https://jobs.smartrecruiters.com/Ubisoft2/744000161884795",
  "salary": null,
  "language": "en"
}
```

#### What SmartRecruiters publishes

Share of jobs that had each field, measured on 740 live SmartRecruiters jobs:

| Field | Jobs with it |
|---|---|
| Department | 40% |
| Team | 0% |
| Employment type | 100% |
| Experience level | 100% |
| Locations | 100% |
| Workplace type (remote / hybrid / onsite) | 28% |
| Posted date | 100% |
| Salary range | 0% |
| Apply link | 100% |

SmartRecruiters boards can be very large (Bosch lists about 5,000 jobs). Use *Max jobs per company* and the keyword and location filters to keep a run small; with *Only new jobs* on, what you held back is delivered in the next runs.

### Pricing

Pay per result: **$2 per 1,000 jobs**. AI fields are a separate **$4 per 1,000 jobs**, only when you switch them on. No monthly fee. Set a maximum cost per run in the run options and the Actor stops cleanly at that limit; jobs it did not deliver stay "new" for your next run.

### Use cases

- Job boards, newsletters and alerts that follow a fixed list of companies
- Recruiting and sales teams tracking who is hiring for which roles
- Market and salary research from employers' own postings
- Candidates filtering for visa sponsorship, relocation and remote regions
- AI agents that need fresh, structured job data (works through the Apify MCP server)

### More than one ATS?

This Actor reads any of the ten ATS when you paste their links. If you follow companies on many different ATS and want to paste plain company names without knowing which ATS they use, try [Company Careers Jobs API](https://apify.com/sandy_cornfield/company-jobs-api): it checks all ten.

### Data and compliance

The Actor reads SmartRecruiters's public job-board feed and, when you give one, the company's own public careers page to find its board. Requests are polite, with no login and no workaround of any access control; private and internal network addresses are refused. The output contains what employers publish for candidates. Recruiter names, emails and phone numbers are not extracted as fields. Descriptions are the employer's own text and may include a contact address the employer chose to publish.

### Messages in the run log and what to do

| Message | What it means | What to do |
|---|---|---|
| `not found` | No SmartRecruiters board with that name | Open one job on the company's careers page and paste that job's link, or the careers page itself |
| `no supported job board found on this page` | The careers page loads its jobs with JavaScript or uses an ATS this Actor does not read (Workday, BambooHR, iCIMS ...) | Paste the link of one job |
| `HTTP 429` / `HTTP 5xx` | SmartRecruiters was busy; the Actor already retried | Run again later; with **Only new jobs** on, nothing is lost or charged twice |
| `Stopped at your maximum cost per run` | Your cost limit was reached | Raise the limit or narrow the filters; undelivered jobs stay new |
| `AI fields are not available right now` | AI enrichment is temporarily off on our side | Jobs are still delivered, without AI fields, and AI is not charged |

### FAQ

**Is this the official SmartRecruiters API?** No. It reads the public job-board feed SmartRecruiters provides for careers pages and job syndication, so you need no SmartRecruiters account or API key.

**How fresh is the data?** Every run reads the live board, so you get what is published at that moment.

**Can I get the full job description?** Yes: switch on *Include full description*.

# Actor input Schema

## `companies` (type: `array`):

One per line. A company name on SmartRecruiters (Ubisoft2), a SmartRecruiters board or job URL, or the company's own careers page (the Actor finds the board behind it). Links to the other supported ATS work too.

## `keywords` (type: `array`):

Keep jobs whose title contains any of these words. Leave empty for all jobs.

## `excludeKeywords` (type: `array`):

Drop jobs whose title contains any of these words.

## `locations` (type: `array`):

Keep jobs where any location contains one of these, e.g. 'London', 'Dubai', 'Remote'.

## `workplaceTypes` (type: `array`):

Keep only these workplace types, as reported by the ATS. Add 'unknown' to keep jobs that do not say.

## `postedWithinDays` (type: `integer`):

Keep jobs published in the last N days. Jobs without a date are kept.

## `includeDescription` (type: `boolean`):

Adds the plain-text description, plus free keyword flags for visa sponsorship and relocation.

## `onlyNew` (type: `boolean`):

Remembers what this input already delivered, so a scheduled run returns only new postings.

## `aiEnrichment` (type: `boolean`):

Adds AI-extracted visa sponsorship (with the quote), relocation support, remote regions, normalised salary, seniority, years of experience, skills and required languages. Charged per enriched job; failed enrichments are not charged.

## `maxJobs` (type: `integer`):

Stop after this many jobs.

## `maxJobsPerCompany` (type: `integer`):

Stop after this many jobs from each company, so one large board does not use up the whole run. Jobs held back stay 'new' for the next run.

## Actor input object example

```json
{
  "companies": [
    "Ubisoft2",
    "https://jobs.smartrecruiters.com/Wise"
  ],
  "includeDescription": false,
  "onlyNew": false,
  "aiEnrichment": false,
  "maxJobsPerCompany": 50
}
```

# Actor output Schema

## `jobs` (type: `string`):

All delivered jobs as JSON.

## `jobsOverview` (type: `string`):

Company, title, locations, workplace type, posted date, salary and link.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companies": [
        "Ubisoft2",
        "https://jobs.smartrecruiters.com/Wise"
    ],
    "maxJobsPerCompany": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("sandy_cornfield/smartrecruiters-jobs-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "companies": [
        "Ubisoft2",
        "https://jobs.smartrecruiters.com/Wise",
    ],
    "maxJobsPerCompany": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("sandy_cornfield/smartrecruiters-jobs-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companies": [
    "Ubisoft2",
    "https://jobs.smartrecruiters.com/Wise"
  ],
  "maxJobsPerCompany": 50
}' |
apify call sandy_cornfield/smartrecruiters-jobs-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sandy_cornfield/smartrecruiters-jobs-api"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/GNgm1dvi4sIjWPwIE/builds/AdgikrFJxzZS21u4k/openapi.json
