{ "openapi": "3.0.1", "info": { "title": "SimplyHired Jobs Scraper | $0.8 / 1k | All In One", "description": "Extract structured SimplyHired job listings with titles, salaries, company data, locations, full descriptions and more across US, Canada, and all localized markets. Built for enterprise-grade hiring intelligence, labor market analysis, and automated recruiting or analytics pipelines.", "version": "0.0", "x-build-id": "8md9aAs0xYxOQnIzQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~simplyhired-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-simplyhired-jobs-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/fatihtahta~simplyhired-jobs-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-simplyhired-jobs-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/fatihtahta~simplyhired-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-simplyhired-jobs-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": { "country": { "title": "Choose a Country to Search", "enum": [ "united-states", "canada", "china", "argentina", "australia", "austria", "belgium", "brazil", "germany", "spain", "france", "india", "ireland", "italy", "japan", "mexico", "netherlands", "portugal", "south-africa", "south-korea", "sweden", "switzerland", "united-kingdom" ], "type": "string", "description": "Select the country version of SimplyHired you want to search. This decides which local job marketplace the run uses and helps return listings that match that region.", "default": "united-states" }, "queries": { "title": "Add Search Terms", "type": "array", "description": "Enter one or more keywords such as job titles, tools, industries, or employer names. Use multiple entries if you want to compare different searches in the same run.", "items": { "type": "string" } }, "location": { "title": "Choose a Search Location (City, State or a Zip Code)", "type": "string", "description": "Enter a city, state, ZIP or postal code, or place name to focus the search on that area. If you type a place name, the actor will try to match it to the location format SimplyHired expects." }, "radius": { "title": "Set the Search Radius", "enum": [ "exact", "5", "10", "15", "25", "50", "100" ], "type": "string", "description": "Choose how far from your selected location results can appear. Use a smaller radius for highly local roles or a larger one to include nearby cities and suburbs.", "default": "25" }, "remote_only": { "title": "Show Only Remote Jobs", "type": "boolean", "description": "Turn this on to focus the run on remote opportunities instead of a physical search area. This is useful when you want work-from-home roles regardless of city or region. Country selection still applies." }, "min_salary": { "title": "Set a Minimum Salary", "minimum": 0, "type": "integer", "description": "Enter the lowest salary you want included in the search results. This helps reduce noise when you only want roles above a certain pay threshold." }, "date_published": { "title": "Filter by Posting Date", "enum": [ "1", "7", "14", "30" ], "type": "string", "description": "Choose how recently a job must have been posted to appear in the results. This is helpful when you want to focus on active opportunities from the past few days or weeks." }, "job_type": { "title": "Choose a Job Type", "enum": [ "CF3CP", "75GKK", "NJXCK", "4HKF7", "VDTG7" ], "type": "string", "description": "Select a job type to narrow results to the kinds of roles that fit your needs. Leave it unset if you want a broader mix of opportunities." }, "sort_by": { "title": "Choose How to Sort Results", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort results by relevance when you want the best keyword matches first, or by date when you want to review the most recently posted jobs first.", "default": "relevance" }, "limit": { "title": "Limit Results per Search Term", "minimum": 1, "type": "integer", "description": "Set the maximum number of listings to collect for each search term. Leave this empty if you want the actor to keep going until it reaches all available results." }, "maximize_coverage": { "title": "Maximize Coverage", "type": "boolean", "description": "When enabled, the actor checks the search result count and recursively splits large searches into narrower child searches using available filters such as job type and salary thresholds. The actor respects any filters you already set and will not override user-selected values like job type.", "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 } } } } } } } } } }