SmartRecruiters is the Recruiting AI Company that transfo…", "jobDescriptionHtml": "
Contract Type: 12-Month Fixed-Term ContractQualifications
At least 2 years of…", "additionalInformationHtml": "
SmartRecruiters is proud to be an Equal Employment Opport…", "companyDescriptionText": "SmartRecruiters is the Recruiting AI Company that transforms…", "jobDescriptionText": "Contract Type: 12-Month Fixed-Term Contract\n\nWe're looking f…", "qualificationsText": "Qualifications\n\nAt least 2 years of experience with ETL tool…", "additionalInformationText": "SmartRecruiters is proud to be an Equal Employment Opportuni…", "compensation": null, "companyStatus": "complete", "scanComplete": true, "detailStatus": "ok", "detailHttpStatus": 200, "event": "NEW", "closedAt": null, "changeType": null, "changedFields": null, "updateComparable": null, "contentHash": "1e423cdd2467f140c1efe305e2c673e18a318f42853330a1cedcd085dee9195f", "hashBasis": "detail", "fetchedAt": "2026-10-02T05:04:11.375Z", "observedAt": "2026-10-02T05:04:11.375Z", "sourceListUrl": "https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings?limit=25&offset=0", "sourceDetailUrl": "https://api.smartrecruiters.com/v1/companies/smartrecruiters/postings/744000148454651", "warnings": [] } ``` `null` means the source has no value or the field needs details. `changeType` is `null` because no `previousSnapshot` was given. An empty string means the source section is empty. `event` is `NEW` for every row when no `previousSnapshot` was given. A removed row only has the keys `source`, `sourceId`, `event` (`CLOSED`), `observedAt`, `scanComplete`, `closedAt`, `companyIdentifier`, `postingId`, `title`, `releasedDate`, `changeType`, `contentHash`, `hashBasis`, `companyStatus` and `fetchedAt`. ### Full output field reference All 64 job row fields. Types are JSON types. | Field | Meaning | Type | Can be empty? | Example | | --- | --- | --- | --- | --- | | `source` | Always smartrecruiters. | string | no | `"smartrecruiters"` | | `sourceId` | smartrecruiters:{companyIdentifier}:{postingId}. | string | no | `"smartrecruiters:smartrecruiters:744000148454651"` | | `companyIdentifier` | Canonical SmartRecruiters company identifier from the API (not your spelling). | string | no | `"smartrecruiters"` | | `postingId` | Stable ID of the job inside the company. With companyIdentifier it is the row key. | string | no | `"744000148454651"` | | `uuid` | Posting UUID from the source. | string or null | yes (null) | `"f4a3d5b9-5fa9-48af-ba55-30669c9c3e81"` | | `jobId` | Job ID from the detail record. Null when details are off or unavailable. | string or null | yes (null) | `"77d771c2-3c32-4eec-b9a1-9b7cd6684a16"` | | `jobAdId` | ID of the job ad. | string or null | yes (null) | `"f9fbb59b-d9db-4c26-a4c9-959f920b370a"` | | `refNumber` | Employer reference number, if set. | string or null | yes (null) | `"REF2025N"` | | `title` | Job title from the source with surrounding spaces removed. | string or null | yes (null) | `"Data Operations Consultant"` | | `companyName` | Display name of the company. | string or null | yes (null) | `"SmartRecruiters Inc"` | | `releasedDate` | When the posting was released (ISO 8601 text). | string or null | yes (null) | `"2026-09-09T09:43:26.403Z"` | | `visibility` | Posting visibility from the source, for example PUBLIC. | string or null | yes (null) | `"PUBLIC"` | | `active` | Whether the posting is active. Detail only. | boolean or null | yes (null) | `true` | | `locationCity` | City from the posting location. | string or null | yes (null) | `"Poland"` | | `locationRegion` | Region or state from the posting location. | string or null | yes (null) | `"Remote"` | | `locationCountry` | Country code from the posting location. | string or null | yes (null) | `"pl"` | | `fullLocation` | Readable location line. | string or null | yes (null) | `"Poland, Remote, Poland"` | | `remote` | True when the posting is remote. | boolean or null | yes (null) | `true` | | `hybrid` | True when the posting is hybrid. | boolean or null | yes (null) | `false` | | `latitude` | Latitude as text. Often null. | string or null | yes (null) | `null` | | `longitude` | Longitude as text. Often null. | string or null | yes (null) | `null` | | `address` | Street address. Detail only, often null. | string or null | yes (null) | `null` | | `postalCode` | Postal code. Detail only, often null. | string or null | yes (null) | `null` | | `industry` | Industry label. | string or null | yes (null) | `"Computer Software"` | | `industryId` | Industry ID as text. | string or null | yes (null) | `"computer_software"` | | `department` | Department label. Null when the employer left it empty. | string or null | yes (null) | `"Technical Services"` | | `departmentId` | Department ID as text. | string or null | yes (null) | `"5408931"` | | `function` | Job function label. | string or null | yes (null) | `"Information Technology"` | | `functionId` | Job function ID as text. | string or null | yes (null) | `"information_technology"` | | `typeOfEmployment` | Employment type label, for example Full-time. | string or null | yes (null) | `"Contract"` | | `typeOfEmploymentId` | Employment type ID as text. | string or null | yes (null) | `"contract"` | | `experienceLevel` | Experience level label. | string or null | yes (null) | `"Associate"` | | `experienceLevelId` | Experience level ID as text. | string or null | yes (null) | `"associate"` | | `language` | Language code, for example en or en-GB. | string or null | yes (null) | `"en"` | | `languageName` | Readable language name from the source, for example English. | string or null | yes (null) | `"English"` | | `detailUrl` | Public API URL of the posting detail record. Always set. | string | no | `"https://api.smartrecruiters.com/v1/companies/smartrecrui…` | | `postingUrl` | Public job page. With details it is the posting URL from the source; in list-only runs it is derived from the company ID and posting ID (warning posting_url_derived). | string or null | yes (null) | `"https://jobs.smartrecruiters.com/smartrecruiters/7440001…` | | `applyUrl` | Apply link. Detail only: null when includeDetails is false. | string or null | yes (null) | `"https://jobs.smartrecruiters.com/smartrecruiters/7440001…` | | `referralUrl` | Public referral link from the detail record. Null without details. | string or null | yes (null) | `"https://jobs.smartrecruiters.com/external-referrals/comp…` | | `companyDescriptionHtml` | Company section as raw HTML. Detail only. | string or null | yes (null) | `"
SmartRecruiters is the Recruiting AI Company that tra…` | | `jobDescriptionHtml` | Job section as raw HTML. Detail only. | string or null | yes (null) | `"
Contract Type: 12-Month Fixed-Term ContractQualifications
At least 2 year…` | | `additionalInformationHtml` | Additional information section as raw HTML. Can be an empty string. | string or null | yes (null) | `"
SmartRecruiters is proud to be an Equal Employment Op…` |
| `companyDescriptionText` | Plain-text version of the company section. | string or null | yes (null) | `"SmartRecruiters is the Recruiting AI Company that transf…` |
| `jobDescriptionText` | Plain-text version of the job section. | string or null | yes (null) | `"Contract Type: 12-Month Fixed-Term Contract\n\nWe're loo…` |
| `qualificationsText` | Plain-text version of the qualifications section. | string or null | yes (null) | `"Qualifications\n\nAt least 2 years of experience with ET…` |
| `additionalInformationText` | Plain-text version of the additional information section. | string or null | yes (null) | `"SmartRecruiters is proud to be an Equal Employment Oppor…` |
| `compensation` | Pay object when the employer publishes it, otherwise null. | object or null | yes (null) | `null` |
| `companyStatus` | How completely the company was read: complete, capped, partial, empty_or_unknown or error. | string | no | `"complete"` |
| `scanComplete` | True when the company was read completely (companyStatus complete). | boolean | no | `true` |
| `detailStatus` | ok, unavailable, error or skipped for this posting. | string | no | `"ok"` |
| `detailHttpStatus` | HTTP status of the detail request. Null when skipped. | integer or null | yes (null) | `200` |
| `event` | NEW, UPDATED, UNCHANGED or CLOSED, derived from changeType. Without previousSnapshot every row is NEW. | string | no | `"NEW"` |
| `closedAt` | Time a removed row was detected. Null for all other rows. | string or null | yes (null) | `null` |
| `changeType` | new, updated, unchanged or removed. Null when no previousSnapshot was given. | string or null | yes (null) | `null` |
| `changedFields` | Names of changed fields when they can be named (title, releasedDate). | array or null | yes (null) | `null` |
| `updateComparable` | False when the old and new snapshot used different hash bases, so an update could not be tested. | boolean or null | yes (null) | `null` |
| `contentHash` | SHA-256 of the normalized posting content. Used for diffs. | string | no | `"1e423cdd2467f140c1efe305e2c673e18a318f42853330a1cedcd085…` |
| `hashBasis` | list or detail: which data the hash was built from. | string | no | `"detail"` |
| `fetchedAt` | When the Actor read this row. Never counts as a change. | string | no | `"2026-10-02T05:04:11.375Z"` |
| `observedAt` | Same value as fetchedAt. Never counts as a change. | string | no | `"2026-10-02T05:04:11.375Z"` |
| `sourceListUrl` | Public API list page the row came from. | string | no | `"https://api.smartrecruiters.com/v1/companies/smartrecrui…` |
| `sourceDetailUrl` | Public API detail URL. Null when details were not read. | string or null | yes (null) | `"https://api.smartrecruiters.com/v1/companies/smartrecrui…` |
| `warnings` | Row-level notes, for example detail_unavailable. | array | no | `[]` |
#### Key-value store records
| Record | Content |
| --- | --- |
| `OUTPUT` | `companies[]`: `input`, `identifier`, `canonicalIdentifier`, `status`, `reasons`, `totalFound`, `rowsEmitted`, `pages`, `detailsOk`, `detailsUnavailable`, `detailsError`, `detailsSkipped`, `duplicatesDropped`, `startedAt`, `finishedAt`. |
| `RUN_SUMMARY` | `outcome` (`succeeded`, `partial`, `failed`, `aborted`, `deadline`, `charge_limit`, `input_error`), `message`, `durationMs`, normalized `input`, `inputErrors`, `counters` (rows, requests, retries, bytes, HTTP status counts, `changeCounts`), `removalsSuppressed`, `warnings`. |
| `SNAPSHOT` | `entries[]` with `companyIdentifier`, `postingId`, `title`, `releasedDate`, `contentHash`, `hashBasis`, plus per-company status. Pass `entries` as `previousSnapshot`. |
| `CHANGES` | Only with `previousSnapshot`: `counts`, and keys of `added`, `updated`, `removed`, plus `removalsSuppressed`. |
#### Company status values
| `companyStatus` | Meaning |
| --- | --- |
| `complete` | All postings were read and the count matched the source. |
| `capped` | Stopped at `maxJobsPerCompany` while more exist. |
| `partial` | A page or a detail failed, the count changed during the run, or the deadline came. Rows read so far are kept. |
| `empty_or_unknown` | The source returned 0 postings. The API cannot tell a company with no jobs from a wrong ID. |
| `error` | The board could not be read. |
### Pricing and cost examples
The Actor uses pay per event pricing. You pay only for these two events. Apify platform usage (compute, storage) is included.
| Event | Price (USD) | When it is charged |
| --- | ---: | --- |
| Actor start | 0.002 | Once per run (memory up to 1 GB, which covers every allowed setting). |
| Job posting row | 0.00072 | For each row stored in the dataset, including `removed` rows. |
Price examples:
| Rows stored in the run | Price (USD) |
| ---: | ---: |
| 0 (for example a daily monitor run with no changes, or an empty board) | 0.002 |
| 10 | 0.0092 |
| 100 | 0.074 |
| 1,000 | 0.722 |
| 2,000 (largest tested run) | 1.442 |
Rows are never charged twice in one run, and companies that return nothing add no row charge. A run with invalid input fails before any request but still costs the start event. To cap the cost of one run, set a maximum cost per run in the run options (API parameter `maxTotalChargeUsd`); the Actor then stops with `RUN_SUMMARY.outcome` set to `charge_limit`.
Cost drivers (run time and memory), measured on Apify in October 2026:
| Scenario | Input | Rows | Requests to SmartRecruiters | Run time | Peak memory |
| --- | --- | ---: | ---: | ---: | ---: |
| Small | 1 company, cap 5, details | 1 | 2 | about 2 s | under 50 MB |
| Medium | 1 board of 161 jobs, details | 161 | 163 | 40 s | 60 MB |
| Large | 2 boards, 1124 jobs, details | 1124 | 1137 | 235 s | 159 MB |
| Largest tested | 2 companies, cap 1000 each, details | 2000 | 2020 | 269 s | 179 MB |
| List only | 5 companies, cap 1000, no details | 3284 | 35 | 16 s | 88 MB |
With details on, the Actor makes one request per row plus one list request per 100 rows. Without details it is much faster; the price per row is the same.
### Use cases
| Buyer job | Input path | Output | Key fields |
| --- | --- | --- | --- |
| Watch the hiring of target employers | `companies`, `outputMode: "changes"`, `previousSnapshot` | New, updated and removed postings | `changeType`, `title`, `postingUrl` |
| Build a job list for a research or job board | `companies`, `maxJobsPerCompany` | All current postings | `title`, `fullLocation`, `department`, `applyUrl` |
| Prepare text for search or AI tools | `descriptionFormat: "text"` | Plain-text job sections | `jobDescriptionText`, `qualificationsText` |
| Check a known board is read completely | any run | Status per company | `companyStatus`, `OUTPUT`, `RUN_SUMMARY` |
### Scheduling and monitoring
The Actor does not schedule itself. To run it every day or week, open the Actor, choose **Schedules**, and create a schedule that starts it with your input. A schedule is plain Apify; see the [Apify schedules guide](https://docs.apify.com/platform/schedules).
To monitor changes, each run must receive the `SNAPSHOT.entries` of the run before. Two ways: copy it into the input by hand, or have your own code read the last run's `SNAPSHOT` record through the API and start the next run with it. The Actor does not store history for you.
What to expect: the first run has no `previousSnapshot`, so every row is `NEW` and `changeType` is `null`. Pass its `SNAPSHOT.entries` to the next run. If nothing changed on the board, every posting is `unchanged`. With `outputMode` set to `changes` the dataset is then empty, `RUN_SUMMARY.counters.changeCounts` shows for example `{"unchanged": 4}`, and the run costs only the start event.
### API, MCP and integrations
- **API:** start a run and read results with the [Apify API](https://docs.apify.com/api/v2). Keep your token in an environment variable, never in code.
```bash
curl -s -X POST "https://api.apify.com/v2/acts/81TefPThmCXMKxPXw/runs?waitForFinish=60" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"companies":["smartrecruiters"],"maxJobsPerCompany":5}'
```
Read the rows with `GET https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json` and the snapshot with `GET https://api.apify.com/v2/key-value-stores/{defaultKeyValueStoreId}/records/SNAPSHOT`.
- **Export:** on the Dataset tab choose JSON, CSV or Excel, and pick the fields. See the [dataset storage guide](https://docs.apify.com/platform/storage/dataset).
- **Webhooks and no-code tools:** use an Apify webhook or integration on run success, then read `RUN_SUMMARY.counters.changeCounts` or the `changeType` of rows.
- **MCP and AI agents:** we did not test an MCP setup for this Actor. If you use Apify's MCP server, check that it can see this Actor in your account.
- **Official source:** the data comes from the public [SmartRecruiters Posting API](https://developers.smartrecruiters.com/docs/posting-api).
### Limits and expected partial results
Tested on Apify with the Actor's own runs (build 0.1.1):
- Up to **1000 jobs per company** is proven. A board with 4814 postings was read up to the cap and marked `capped`.
- With details, **2000 rows in one run** took 269 s at 1024 MB. List-only runs returned 3284 rows in 16 s.
- Memory: choose 512 MB for up to about 1100 rows with details, and 1024 MB for about 2000. The Apify default for new runs can be higher; set memory yourself.
- Allowed by the input form but **not tested**: more than 2000 rows with details in one run, 25 companies in one run, and a `previousSnapshot` over 2000 entries. Use smaller batches first.
- The Actor reads about 4 detail requests per second. No rate limit was hit in tests.
- A detail that fails (for example, a posting that disappeared between the list and the detail read) keeps the row with list fields only, sets `detailStatus` and marks the company `partial`. Such a posting is never reported as removed.
- `removed` rows are made only for companies that ended `complete`. Capped, partial, error and empty companies list `removalsSuppressed` in `RUN_SUMMARY` instead.
- With `includeDetails: false`, `postingUrl` is built from the company ID and posting ID (warning `posting_url_derived`, no title slug). `applyUrl`, `referralUrl` and descriptions are `null`. Turn details on if you need them.
- If you set a maximum total charge and the run reaches it, the Actor stops, `RUN_SUMMARY.outcome` is `charge_limit`, the company that was cut and all unread companies are `partial` with reason `charge_limit` (`rowsEmitted` counts only stored rows), and `SNAPSHOT.incomplete` is `true`. Do not use that snapshot as `previousSnapshot`.
- The source can change while you read it. Job counts on live boards move.
### Troubleshooting
#### The run failed with `input_error`
Symptom: no rows, `RUN_SUMMARY.outcome` is `input_error`. Likely reason: a company item is not an ID or a SmartRecruiters board URL, or `outputMode` is `changes` without `previousSnapshot`. Check `RUN_SUMMARY.inputErrors`. Action: fix the named item and start again.
#### The dataset is empty but the run succeeded
Symptom: 0 rows. Likely reason: the company has no public postings, or the ID is wrong. The API answers the same way for both, so the status is `empty_or_unknown`, not "not found". Check the ID on the company career page.
#### Apply link and descriptions are `null`
Symptom: `applyUrl` and descriptions are `null`. Reason: `includeDetails` is `false`, or `descriptionFormat` excludes that form. Action: turn details on.
#### A company shows `partial` or `capped`
`capped` means your `maxJobsPerCompany` was reached. Raise it. `partial` means a page or detail failed, or the deadline came. Read `OUTPUT[].reasons`, raise `timeoutSecs` if needed, and run again. Do not trust `removed` rows for that company.
#### Rows show `updateComparable: false`
The old snapshot was made with different details settings. Run once more with the same settings, and feed that new snapshot next time.
### FAQ
#### Do I need a SmartRecruiters account or API key?
No. The Actor uses the public Posting API without login. It cannot read internal or private jobs.
#### How do I find a company ID?
Open the career page. The ID is the first part of the path after `jobs.smartrecruiters.com/`. It is not case sensitive; rows show the exact spelling from the source.
#### Can it search jobs by keyword or country across all companies?
No. You choose the companies. Filter the dataset afterwards by `fullLocation`, `locationCountry`, `department` or `typeOfEmployment`.
#### Is the result complete?
Check `companyStatus`. `complete` means the count matched the source at read time. Other values tell you why not. A posting can still be opened or closed right after the run.
#### How does change detection work?
The Actor hashes the normalized content of each posting and compares it with your `previousSnapshot` by company and posting ID. A new `fetchedAt` or `observedAt` is never a change. Title and release date changes are named in `changedFields`; other changes give `updated` with an empty list.
#### Does it send alerts?
No. Schedule runs and connect Apify integrations to the dataset or `RUN_SUMMARY`.
#### Can I use it in place of another SmartRecruiters monitor Actor?
For the main job fields, yes: it uses the same field names and values as a popular SmartRecruiters monitor Actor (`source`, `sourceId`, `postingId`, `title`, location, `postingUrl`, `applyUrl`, `detailUrl`, `referralUrl`, `language`, description HTML, `event`, `observedAt`, `scanComplete`). In a test on 5 postings all of those matched. Differences: empty fields are `null` or `""` here and are left out there; `event` values other than `NEW` were not observed on the other Actor; it has no `previousSnapshot` input. This Actor also adds fields such as plain-text descriptions and `contentHash`. Test with your own data before you switch.
### Related Actors
None yet.
### Support
For a bug, a question or a feature request, use the **Issues** tab on this Actor's Store page. Add the run ID, the input mode and non-sensitive error text. Never post tokens, cookies or private data. This is an independent tool and is not affiliated with SmartRecruiters. It reads only data that the public Posting API returns.
# Actor input Schema
## `companies` (type: `array`):
SmartRecruiters company identifiers (e.g. McDonaldsCorporation) or board URLs such as https://jobs.smartrecruiters.com/McDonaldsCorporation. Identifiers are case-insensitive; duplicates are merged.
## `maxJobsPerCompany` (type: `integer`):
Stop reading a company after this many postings. A company stopped by this cap is reported as capped and never produces removals.
## `includeDetails` (type: `boolean`):
Fetch the detail record of every posting (descriptions, apply URL, compensation). One extra request per posting; off = list fields only.
## `descriptionFormat` (type: `string`):
Which description representation to output when details are included.
## `previousSnapshot` (type: `array`):
The SNAPSHOT.entries array saved by an earlier run. Enables changeType (new/updated/unchanged) and removed rows. Removals are only reported for companies read completely in this run.
## `outputMode` (type: `string`):
all = every current posting; changes = only new, updated and removed postings (requires previousSnapshot).
## `timeoutSecs` (type: `integer`):
Stop gracefully after this time; unfinished companies are reported as partial.
## Actor input object example
```json
{
"companies": [
"smartrecruiters"
],
"maxJobsPerCompany": 10,
"includeDetails": true,
"descriptionFormat": "both",
"outputMode": "all",
"timeoutSecs": 900
}
```
# Actor output Schema
## `jobs` (type: `string`):
No description
## `output` (type: `string`):
No description
## `runSummary` (type: `string`):
No description
## `snapshot` (type: `string`):
No description
## `changes` (type: `string`):
No description
# 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 '