{ "openapi": "3.0.1", "info": { "title": "SimplyHired Job Search & Salary Parser", "description": "Search SimplyHired by keyword, location, employment type, remote work, and salary, and get parsed salary ranges, benefits, qualifications, and full descriptions for each job.", "version": "1.0", "x-build-id": "GlALe8LJK6Pfmj3Te" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~simplyhired-job-search-and-salary-parser/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-simplyhired-job-search-and-salary-parser", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dataspryva~simplyhired-job-search-and-salary-parser/runs": { "post": { "operationId": "runs-sync-dataspryva-simplyhired-job-search-and-salary-parser", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dataspryva~simplyhired-job-search-and-salary-parser/run-sync": { "post": { "operationId": "run-sync-dataspryva-simplyhired-job-search-and-salary-parser", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "What to fetch: search jobs on SimplyHired, or scrape specific SimplyHired URLs you already have.", "default": "search" }, "searchQueries": { "title": "Search queries (mode=search)", "type": "array", "description": "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.", "default": [], "items": { "type": "string" } }, "searchUrls": { "title": "SimplyHired search URLs (mode=search)", "type": "array", "description": "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.", "default": [], "items": { "type": "string" } }, "jobUrls": { "title": "Specific URLs (mode=byUrl)", "type": "array", "description": "SimplyHired job URLs (https://www.simplyhired.com/job/...) or search URLs to scrape directly. Job IDs may also be pasted on their own.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, state, ZIP code, or `remote`. Leave empty to search nationwide (mode=search).", "default": "" }, "country": { "title": "Country", "enum": [ "united-states", "canada", "united-kingdom", "ireland", "germany", "france", "spain", "italy", "netherlands", "belgium", "austria", "switzerland", "portugal", "sweden", "india", "japan", "south-korea", "china", "brazil", "mexico", "australia", "argentina", "south-africa" ], "type": "string", "description": "Which SimplyHired site to search (mode=search). Choose the country that matches your location.", "default": "united-states" }, "radius": { "title": "Search radius", "enum": [ "", "exact", "5", "10", "15", "25", "50", "100" ], "type": "string", "description": "Distance around the location (mode=search). Only applies when a location is set.", "default": "" }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "date", "distance" ], "type": "string", "description": "Order of the search results (mode=search).", "default": "relevance" }, "datePosted": { "title": "Date posted", "enum": [ "", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only include jobs added within this window (mode=search).", "default": "" }, "employmentType": { "title": "Employment type", "enum": [ "", "CF3CP", "NJXCK", "75GKK", "4HKF7", "5QWDV", "VDTG7", "7SBAT", "ZG59D" ], "type": "string", "description": "Filter by employment type (mode=search).", "default": "" }, "minSalary": { "title": "Minimum salary", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "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.", "default": 0 }, "remoteType": { "title": "Remote work", "enum": [ "", "Remote", "Hybrid work" ], "type": "string", "description": "Filter by remote work arrangement (mode=search).", "default": "" }, "developerSkill": { "title": "Developer skill", "enum": [ "", "JB2WC", "X62BT", "84K74", "WD7PP", "FGY89", "EVPJU", "AP3T4", "6XQ9P", "6ETQT", "GJUK3", "NGEEK", "U5AXZ", "6M28R", "EHNJH", "XH9RQ", "FQMG4", "AGW49", "JQ94N", "GKAXA", "KTEH7", "5FG4F" ], "type": "string", "description": "Only jobs tagged with this software skill (mode=search). Applies mainly to tech roles; combine several skills with Developer skills below.", "default": "" }, "developerSkills": { "title": "Developer skills (extra, combined with AND)", "type": "array", "description": "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.", "default": [], "items": { "type": "string" } }, "fetchJobDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Fetch each job's detail payload for the full description, parsed salary, coordinates, qualifications and employer rating. Adds one fast request per job. Turn off for search-card fields only.", "default": true }, "enrichCompanyPages": { "title": "Enrich employer company pages", "type": "boolean", "description": "Look up each employer's SimplyHired company page (once per employer) and add its address, size, revenue band and industry when the page's company name matches the listing. Off by default.", "default": false }, "maximizeCoverage": { "title": "Maximize coverage (slower)", "type": "boolean", "description": "When a search hits SimplyHired's per-search result limit, continue with extra facet searches (job types and developer skills) and merge the unique jobs. Slower and uses more requests, but returns more of the matching jobs.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on the number of job records returned.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }