{ "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": "lZdfUfHvniy9S6hl8" }, "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.", "default": "United States" }, "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.", "default": "any" }, "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.", "default": "all" }, "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.", "default": "0" }, "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.", "default": "25" }, "sort": { "title": "Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "How results are ordered. 'Relevance' is SimplyHired's default ranking; 'Date' surfaces the newest postings first.", "default": "relevance" }, "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 (an internal safety limit of 50,000 still applies to prevent runaway pagination). The actor stops requesting new pages once this number is reached but keeps the full final page even if it slightly overshoots.", "default": 100 }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "When on, the actor fetches each job's detail page to populate the full long-form description, qualifications list, and apply URL. Turn off to keep only the search-card fields (title, company, location, salary, snippet, benefits) — about 17× fewer requests per job and a much faster run.", "default": false } } }, "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 } } } } } } } } } }