{ "openapi": "3.0.1", "info": { "title": "Jobs Scraper All-in-One — Listings, Salaries & Insights", "description": "Search live job postings from Indeed, LinkedIn, Glassdoor and company career pages in one run. Each comes back with its pay range, employer, location, posting date and apply link. Add the going rate for roles that quote no pay, and what each posting asks of a candidate.", "version": "0.1", "x-build-id": "hcvKJVamlAQzf1GJ3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/toolzerhub~jobs-scraper-all-in-one/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-toolzerhub-jobs-scraper-all-in-one", "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/toolzerhub~jobs-scraper-all-in-one/runs": { "post": { "operationId": "runs-sync-toolzerhub-jobs-scraper-all-in-one", "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/toolzerhub~jobs-scraper-all-in-one/run-sync": { "post": { "operationId": "run-sync-toolzerhub-jobs-scraper-all-in-one", "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": [ "query" ], "properties": { "query": { "title": "Search Terms", "type": "array", "description": "What to look for — a role, a role and a place, or a company name. Add several and the run collects all of them.", "default": [ "software engineer" ], "items": { "type": "string" } }, "maxItems": { "title": "Max Results", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many postings to save across every search term. Set 0 for no limit.", "default": 10 }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code the search runs in — us, gb, de, ca, au, in. Leave empty for us." }, "language": { "title": "Language", "enum": [ "", "en", "de", "fr", "es", "it", "pt", "nl", "ja", "zh", "ru", "ar", "hi" ], "type": "string", "description": "Language for the postings. Leave on Default to follow the country.", "default": "" }, "postedWithin": { "title": "Posted Within", "enum": [ "", "today", "3_days", "week", "month" ], "type": "string", "description": "Only keep postings first published inside this window.", "default": "" }, "remoteOnly": { "title": "Remote Only", "type": "boolean", "description": "Keep only postings that can be worked from home.", "default": false }, "employmentType": { "title": "Employment Type", "enum": [ "", "full_time", "part_time", "contract", "internship" ], "type": "string", "description": "Keep only one kind of engagement.", "default": "" }, "requirement": { "title": "Candidate Requirement", "enum": [ "", "no_experience", "under_3_years", "over_3_years", "no_degree_required" ], "type": "string", "description": "Keep only postings asking this of a candidate.", "default": "" }, "radiusKm": { "title": "Search Radius", "minimum": 1, "maximum": 500, "type": "integer", "description": "How far from the place named in the search term to look." }, "excludeBoards": { "title": "Exclude Boards", "type": "string", "description": "Comma-separated board names to drop from the results, such as BeeBe,Dice." }, "includeJobInsights": { "title": "Add Job Insights", "type": "boolean", "description": "Read each posting in full and attach what it asks for: seniority, years of experience, required and preferred technologies, work arrangement, visa sponsorship, start date and contract length. Billed per posting enriched.", "default": false }, "includePayEstimate": { "title": "Add Pay Estimate", "type": "boolean", "description": "Attach the going rate for each posting's role in its own location, split into base pay and everything on top. Most postings quote no pay at all, and this fills that gap. Billed per estimate, and postings sharing a role and location are estimated once.", "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 } } } } } } } } } }