{ "openapi": "3.0.1", "info": { "title": "SimplyHired Scraper", "description": "[💰 $0.95 / 1K] Extract US job listings from SimplyHired — title, company, location, salary, employment type, description, qualifications, benefits, and apply URL. Search by keyword + location with filters for date posted, job type, salary, and distance.", "version": "1.0", "x-build-id": "YcpNlVmGGfYxhDwyd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~simplyhired-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-simplyhired-scraper", "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/solidcode~simplyhired-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-simplyhired-scraper", "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/solidcode~simplyhired-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-simplyhired-scraper", "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", "properties": { "keywords": { "title": "Keywords", "maxItems": 50, "type": "array", "description": "Job-title or skill keywords to search (e.g. 'software engineer', 'registered nurse'). Each keyword runs as its own search and is combined with the Location below. Up to 50 keywords per run — extras are silently dropped. Leave empty if you are pasting full SimplyHired URLs instead.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Where to search: a city, state, ZIP code, or 'Remote'. Applied to every keyword. Leave as the default 'United States' for a nationwide search." }, "startUrls": { "title": "SimplyHired URLs", "type": "array", "description": "Paste SimplyHired search URLs directly (e.g. https://www.simplyhired.com/search?q=nurse&l=Boston). Any filters in the URL are honored as-is — useful when you have a fine-tuned search you want to repeat.", "items": { "type": "string" } }, "datePosted": { "title": "Date Posted", "enum": [ "any", "1", "7", "14", "30" ], "type": "string", "description": "Only include jobs posted within this window." }, "jobType": { "title": "Employment Type", "enum": [ "all", "fulltime", "parttime", "contract", "temporary", "internship" ], "type": "string", "description": "Restrict to one employment type. Choose 'All types' to leave it unfiltered." }, "minSalary": { "title": "Minimum Salary (USD/year)", "enum": [ "0", "40000", "60000", "80000", "100000", "120000", "150000", "175000", "200000", "225000" ], "type": "string", "description": "Only show jobs offering at least this annual salary in US dollars. Choose 'No minimum' to leave unfiltered." }, "distance": { "title": "Distance from Location", "enum": [ "exact", "5", "10", "15", "25", "50", "100" ], "type": "string", "description": "Search radius around the Location (in miles). 'Exact location' restricts to jobs in that city only." }, "sort": { "title": "Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "How results are ordered. 'Relevance' is SimplyHired's default ranking; 'Date' asks SimplyHired to favour recent postings, which brings fresher jobs toward the front. It is a recency ranking, not a strict timestamp sort, so rows are not returned in exact posting order. To limit results to genuinely recent jobs, use 'Date Posted'." }, "maxResults": { "title": "Maximum Results", "minimum": 0, "type": "integer", "description": "Hard cap on total job rows across all keywords and URLs. Set to 0 for no cap (a 50,000-row ceiling still applies). The run stops looking for more jobs once this number is reached but keeps the full final page of 20, so a 100-cap run hands back 100 to 120 rows rather than exactly 100." }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "On by default: every job row carries the full long-form description, the qualifications list, and a working apply link. Turn it off and exactly three fields go empty — description, qualifications and applyUrl. Title, company, location, salary and pay period, employment type, shift tags, benefits and posted date all still arrive, and jobs land in your dataset about 1.6 to 1.8× faster." } } }, "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 } } }, "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 } } } } } } } } } }