SimplyHired Job Search & Salary Parser: MCP config, n8n workflow and API

{
  "mode": "search",
  "searchQueries": [
    "software engineer"
  ],
  "location": "New York",
  "country": "united-states",
  "sortBy": "relevance",
  "minSalary": 0,
  "fetchJobDetails": true,
  "enrichCompanyPages": false,
  "maximizeCoverage": false,
  "maxItems": 3
}

---
name: simplyhired-job-search-and-salary-parser
description: "SimplyHired job records from 23 country sites with parsed salary ranges, employment types, remote-work status, coordinates, full descriptions and application links. Runs the Apify Actor dataspryva/simplyhired-job-search-and-salary-parser. Use when the user needs SimplyHired data with fields such as title, company, location, salary, salaryMin, salaryMax and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/simplyhired-job-search-and-salary-parser"
  store-url: "https://apify.com/dataspryva/simplyhired-job-search-and-salary-parser"
---

# SimplyHired Job Search & Salary Parser

Use this skill to fetch SimplyHired data with the Apify Actor `dataspryva/simplyhired-job-search-and-salary-parser` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `search`, `byUrl`, required | What to fetch: search jobs on SimplyHired, or scrape specific SimplyHired URLs you already have. |
| `searchQueries` | array | One or more job titles, skills, or keywords. Each entry runs as its own search, e.g. `registered nurse` or `python developer, remote`. Ignored when Search URLs are provided. |
| `searchUrls` | array | Full SimplyHired search URLs, including any filters and a country domain (e.g. https://www.simplyhired.co.uk/search?q=nurse&l=London). When provided, these are used instead of the query, location and filter fields. |
| `jobUrls` | array | SimplyHired job URLs (https://www.simplyhired.com/job/...) or search URLs to scrape directly. Job IDs may also be pasted on their own. |
| `location` | string | City, state, ZIP code, or `remote`. Leave empty to search nationwide (mode=search). |
| `country` | string | Which SimplyHired site to search (mode=search). Choose the country that matches your location. |
| `radius` | one of `exact`, `5`, `10`, `15`, `25`, `50`, `100` | Distance around the location (mode=search). Only applies when a location is set. |
| `sortBy` | one of `relevance`, `date`, `distance` | Order of the search results (mode=search). |
| `datePosted` | one of `1`, `3`, `7`, `14`, `30` | Only include jobs added within this window (mode=search). |
| `employmentType` | string | Filter by employment type (mode=search). |
| `minSalary` | integer | Only jobs with pay at or above this amount, in the local currency of the selected country (e.g. 100000 = $100,000 a year on the US site). Leave 0 for no filter. |
| `remoteType` | one of `Remote`, `Hybrid work` | Filter by remote work arrangement (mode=search). |
| `developerSkill` | string | Only jobs tagged with this software skill (mode=search). Applies mainly to tech roles; combine several skills with Developer skills below. |
| `developerSkills` | array | Additional software skills to require together with the Developer skill above (mode=search). Use skill names such as `Python`, `SQL`, `React` (or their codes). Jobs must match every listed skill. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "searchQueries": [
    "software engineer"
  ],
  "location": "New York",
  "country": "united-states",
  "sortBy": "relevance",
  "minSalary": 0,
  "fetchJobDetails": true,
  "enrichCompanyPages": false,
  "maximizeCoverage": false,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~simplyhired-job-search-and-salary-parser/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~simplyhired-job-search-and-salary-parser/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `title`, `company`, `location`, `salary`, `salaryMin`, `salaryMax`, `salaryCurrency`, `employmentType`, `remoteType`, `datePosted`, `jobUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.