Full long-form HTML description appears here.
"` | | `descriptionText` | `"Full long-form description as plain text appears here."` | | `requirements` | `["Python", "AWS"]` | | `qualifications` | `["Bachelor's degree", "5+ years experience"]` | | `benefits` | `["Health insurance", "401(k)"]` | | `skillsAll` | `["Python", "AWS", "API design"]` | | `datePosted` | `"2026-01-01T00:00:00.000Z"` | | `datePostedEpochMs` | `1735689600000` | | `dateOnIndeed` | `1735689600000` | | `applyUrl` | `"https://example.com/apply/000"` | | `mobileApplyUrl` | `"https://example.com/m/apply/000"` | | `indeedApply` | `false` | | `sponsored` | `false` | | `auction` | `false` | | `expired` | `false` | | `jobCardTrackingKey` | `"0-pdx0-0-0000000000000000-0000000000000000"` | | `jobTypeRequested` | `"fulltime"` | | `searchQuery` | `"software engineer"` | | `searchLocation` | `"Remote"` | | `pageNumber` | `1` | | `source` | `"SimplyHired"` | | `scrapedAt` | `"2026-01-01T00:00:00.000Z"` | | `changeType` (incremental mode only) | `"NEW"` | | `changedFields` (incremental mode only) | `["salary"]` | | `firstSeenAt` (incremental mode only) | `"2026-01-01T00:00:00.000Z"` | | `lastSeenAt` (incremental mode only) | `"2026-01-02T00:00:00.000Z"` | ### How to Use #### 1) Search by keyword + location ```json { "mode": "search", "queries": ["software engineer"], "location": "Remote", "country": "us", "jobType": "fulltime", "maxPages": 5, "maxListings": 100, "fetchDetails": true } ``` #### 2) Search multiple keywords with full enrichment ```json { "mode": "search", "queries": ["nurse", "physical therapist", "medical assistant"], "location": "Boston, MA", "country": "us", "jobType": "any", "skipSponsored": true, "maxPages": 3, "maxListings": 150, "fetchDetails": true } ``` #### 3) UK or Canada site ```json { "mode": "search", "queries": ["product manager"], "location": "London", "country": "uk", "jobType": "fulltime", "maxPages": 5, "maxListings": 100 } ``` #### 4) URL mode (paste any SimplyHired URL, including a single job) ```json { "mode": "url", "urls": [ "https://www.simplyhired.com/search?q=software+engineer&l=Remote", "https://www.simplyhired.com/search?q=nurse&l=Boston%2C+MA", "https://www.simplyhired.com/job/abcd1234example" ], "maxPages": 5, "maxListings": 250, "fetchDetails": true } ``` #### 5) Recurring monitoring (scheduled daily run, only what changed) ```json { "mode": "search", "queries": ["software engineer"], "location": "Remote", "country": "us", "maxListings": 0, "fetchDetails": true, "incrementalMode": true, "emitExpired": true } ``` Schedule this same input to run daily. The first run returns everything as `NEW`. Every later run returns only `NEW`, `UPDATED`, and `REAPPEARED` listings (plus `EXPIRED` ones here, since `emitExpired` is on) — not the full result set again. ### Input Parameters | Parameter | Type | Default | Description | |---|---|---|---| | `mode` | enum | `search` | `search` (use builder fields) or `url` (paste URLs). | | `queries` | array of strings | `["software engineer"]` | One scrape per keyword. Empty = browse without keyword filter. | | `location` | string | `Remote` | City, state, ZIP, or "Remote". Examples: "New York, NY", "94103". | | `country` | enum | `us` | Which SimplyHired regional site: `us`, `uk`, `ca`, `au`, `ie`, `in`. | | `jobType` | enum | `any` | `any` / `fulltime` / `parttime` / `contract` / `temporary` / `internship` / `commission`. | | `skipSponsored` | bool | `false` | Drop sponsored / promoted job cards. | | `urls` | array of strings | example URL | URL mode only. Each URL is paged forward independently. | | `maxPages` | int | (empty) | Max SERP pages per search (or per pasted URL). Each page returns up to 20 listings. Leave empty to walk every result page. | | `maxListings` | int | `20` | Cap across all searches. `0` = no cap. | | `fetchDetails` | bool | `true` | Also fetch each job's detail page for the full HTML description, qualifications list, employer logo, lat/lng, and apply URL. | | `resumeFromRunId` | string | (empty) | A previous run ID or dataset ID to continue a full-catalogue walk across separate runs. Listings already collected there (matched by `id`) are skipped, so this run only saves the new ones. For recurring daily monitoring of the same search, use `incrementalMode` below instead. | | `incrementalMode` | bool | `false` | Turn on for daily/recurring monitoring of the same search. The first run returns everything as `NEW`; later runs return only `NEW`, `UPDATED`, and `REAPPEARED` listings by default. See "Resume & recurring updates" below. | | `stateKey` | string | (empty) | Incremental mode only. Names the monitoring campaign so its state stays stable, or so you can deliberately share state across differently-configured runs. Leave empty to derive a key automatically from the query/location/URL and detail settings. | | `emitUnchanged` | bool | `false` | Incremental mode only. Also return (and bill) listings that haven't changed, marked `UNCHANGED`. | | `emitExpired` | bool | `false` | Incremental mode only. Also return (and bill) listings from a previous run that are no longer found, marked `EXPIRED`. Only produced after a run that fully scanned the tracked search. | | `proxy` | object | Apify Residential US | SimplyHired requires residential routing pinned to the country site you query (Datacenter exit IPs are rejected). Default = `{ useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"], apifyProxyCountry: "US" }`. For other regions set the country code to match (GB / CA / AU / IE / IN). Apify Free plans without residential access can paste their own residential proxy URLs in this field. | #### Resume & recurring updates Two different things, both under one input section, so they don't get confused: - **`resumeFromRunId`** continues **one specific interrupted run**. Paste the ID of a previous run (or its dataset), and this run skips every listing `id` already saved there, appending only new listings. Good for an unbounded pull (`maxPages` left empty, `maxListings: 0`) that got cut off. - **`incrementalMode`** is for **recurring monitoring of the SAME search** (e.g. scheduled daily). Turn it on and the actor remembers the previous run's results itself — no run/dataset id to paste. Each listing in the output gets a `changeType`: - `NEW` — never seen before for this search. - `UPDATED` — seen before, but at least one field changed since last time (see `changedFields`). - `REAPPEARED` — was previously marked `EXPIRED`, now found again. - `UNCHANGED` — identical to last time. Only emitted when `emitUnchanged` is on (off by default — it would otherwise return, and bill for, rows you already have). - `EXPIRED` — was seen before, no longer found. Only emitted when `emitExpired` is on, and only after a run that fully scanned the tracked search (a capped, blocked, or `resumeFromRunId` run never marks listings expired, since it never proved they're actually gone). State is tracked separately per query/location/country/jobType/skipSponsored/URL-set/`fetchDetails` combination (or under one shared campaign if you set `stateKey`), so two differently-configured runs never mix baselines. `resumeFromRunId` and `incrementalMode` can bootstrap together on the very first incremental run for a search (the resumed dataset seeds the new baseline); combining them once a baseline already exists fails fast instead of silently mixing a partial scan into the state. Independently of both, a **checkpoint** is saved automatically as the run progresses. If the run is interrupted by an Apify platform migration or you click **Resurrect** on a failed run, it picks back up in the *same* run without re-saving (or re-charging for) listings it already collected. No input is needed for this; it's automatic. ### Send results into your apps (MCP connectors) Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape — the Apify dataset is never changed. **What gets written to the connector:** a condensed, human-readable **summary** of each record — not the full JSON. Each item becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**. 1. Authorize a connector once under **Apify → Settings → Integrations** (Notion, Linear, Airtable, or Apify). 2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.) 3. For **Notion**, also set `notionParentPageUrl` to the page where items should be created. The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip. ### Output Example > Sample shape: values are illustrative placeholders, not from a live ad. `changeType`, `changedFields`, `firstSeenAt`, and `lastSeenAt` are only added when `incrementalMode` is on — a normal run's output shape below is unchanged. ```json { "id": "abcd1234example", "url": "https://www.simplyhired.com/job/abcd1234example", "title": "Sample Job Title", "displayTitle": "Sample Display Title", "normalizedTitle": "sample title", "company": "Sample Company Inc", "companyRating": 4.2, "companyPageUrl": "https://www.simplyhired.com/company/000-sample", "employerLogoUrl": "https://d2qvg5qoitbwggvh.cloudfront.net/sample-logo.png", "employerHomepage": "https://www.example.com/", "location": "Remote", "formattedLocation": "Remote", "city": "Remote", "state": null, "latitude": 40.7128, "longitude": -74.006, "country": "us", "jobTypes": ["Full-time"], "workSettings": ["Remote"], "remoteAttributes": ["Remote"], "salary": "$0 - $0 a year", "salaryMin": 140000, "salaryMax": 180000, "salaryCurrency": "USD", "salaryPeriod": "year", "compensation": { "currency": "USD", "period": "year" }, "snippet": "Short listing preview text appears here...", "descriptionHtml": "Full long-form HTML description appears here.
", "descriptionText": "Full long-form description as plain text appears here.", "requirements": ["Python", "AWS"], "qualifications": ["Bachelor's degree", "5+ years experience"], "benefits": ["Health insurance", "401(k)"], "skillsAll": ["Python", "AWS", "API design"], "datePosted": "2026-01-01T00:00:00.000Z", "datePostedEpochMs": 1735689600000, "dateOnIndeed": 1735689600000, "applyUrl": "https://example.com/apply/000", "mobileApplyUrl": "https://example.com/m/apply/000", "indeedApply": false, "sponsored": false, "auction": false, "expired": false, "jobCardTrackingKey": "0-pdx0-0-0000000000000000-0000000000000000", "jobTypeRequested": "fulltime", "searchQuery": "software engineer", "searchLocation": "Remote", "pageNumber": 1, "source": "SimplyHired", "scrapedAt": "2026-01-01T00:00:00.000Z" } ``` ### Plan Requirement This scraper requires Apify Residential proxy access (Apify Starter plan or higher). SimplyHired blocks Datacenter exit IPs, so the default proxy in this actor is `{ useApifyProxy: true, apifyProxyGroups: ["RESIDENTIAL"], apifyProxyCountry: "US" }`. For UK / CA / AU / IE / IN regional sites, change `apifyProxyCountry` to match (`GB`, `CA`, `AU`, `IE`, `IN`). Free-plan users can paste their own residential proxy URLs into the proxy field. # Actor input Schema ## `mode` (type: `string`): Search mode = pick keywords + location + filters below. URL mode = paste any simplyhired.com /search or /job URL refined in your browser. ## `queries` (type: `array`): Free-text search terms (e.g. "software engineer", "nurse", "data analyst"). One scrape per keyword. Leave empty to browse without a keyword filter. ## `location` (type: `string`): City, state, ZIP, or "Remote". Examples: "New York, NY", "Boston, MA", "94103", "Remote". Leave empty to search nationwide. ## `country` (type: `string`): Which SimplyHired regional site to query. The site language follows the host. Defaults to the US site. ## `jobType` (type: `string`): Filter by employment scope. "Any" walks the unfiltered SERP. ## `skipSponsored` (type: `boolean`): Drop sponsored / promoted job cards. Applied as a client-side filter. ## `urls` (type: `array`): One or more simplyhired.com URLs. Examples: https://www.simplyhired.com/search?q=software+engineer\&l=Remote, or a single job URL like https://www.simplyhired.com/job/abc123. Multi-URL supported; each URL pages forward independently. Filter fields above are ignored. ## `maxPages` (type: `integer`): How many SERP pages to walk per query × location combination (or per pasted URL). Each page returns up to 20 listings. Leave empty to walk every result page. Use `maxListings` in tandem to cap the total budget across all searches. ## `maxListings` (type: `integer`): Stop after this many listings across all searches. 0 = no cap. ## `fetchDetails` (type: `boolean`): When ON, also fetch each job's detail page for the full HTML description, qualifications list, employer logo, lat/lng, and apply URL. SERP cards already carry id, title, company, location, snippet, and posted date, so simple feeds work fine with this OFF. Default ON for richer output. ## `resumeFromRunId` (type: `string`): Paste a previous run ID or dataset ID to continue a full-catalogue walk across separate runs. Listings already collected there (matched by id) are skipped, so this run only saves the new ones. Leave empty for a normal fresh run. For recurring daily monitoring of the same search, use Incremental mode below instead. ## `incrementalMode` (type: `boolean`): Turn this on for daily or recurring monitoring. The first run returns all matching listings as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED listings. Turn on "Emit unchanged" or "Emit expired" only when you also want those listings returned (and billed). State is kept separately for each query/location/URL and detail-mode setup; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above. ## `stateKey` (type: `string`): Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the query/location/URL and detail settings — different searches then never mix state with each other. ## `emitUnchanged` (type: `boolean`): Off by default. Turn on to also return listings that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run. ## `emitExpired` (type: `boolean`): Off by default. Turn on to also return listings that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search — not when Max listings capped it or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking. ## `proxy` (type: `object`): SimplyHired requires residential routing pinned to the country you are querying (Datacenter exit IPs are rejected by the upstream edge). The default below works on Apify Starter and higher. Free plans without residential access can paste their own residential proxy URLs in this field. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "queries": [ "software engineer" ], "location": "Remote", "country": "us", "jobType": "any", "skipSponsored": false, "urls": [ "https://www.simplyhired.com/search?q=software+engineer&l=Remote" ], "maxListings": 20, "fetchDetails": true, "incrementalMode": false, "emitUnchanged": false, "emitExpired": false, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (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 '