{ "openapi": "3.0.1", "info": { "title": "Omni Jobs Board Scraper ~$2 per 500 results", "description": "international Jobs Board Scraper\nSearch 14+ job boards across UK, US, EU & remote in one run\nReed, Totaljobs, CV-Library, CWJobs, Indeed (6 countries), USAJobs, RemoteOK, Arbeitnow & Adzuna. Deduplicated results with parsed salaries and optional salary benchmarks.", "version": "0.3", "x-build-id": "XPKfZqbsuKO80XVbd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/doggo~uk-jobs-board-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-doggo-uk-jobs-board-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/doggo~uk-jobs-board-scraper/runs": { "post": { "operationId": "runs-sync-doggo-uk-jobs-board-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/doggo~uk-jobs-board-scraper/run-sync": { "post": { "operationId": "run-sync-doggo-uk-jobs-board-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", "required": [ "keyword", "location" ], "properties": { "keyword": { "title": "Job Role Preset", "enum": [ "software engineer", "data analyst", "data scientist", "web developer", "frontend developer", "backend developer", "fullstack developer", "devops engineer", "cloud engineer", "cybersecurity analyst", "product manager", "project manager", "UX designer", "business analyst", "marketing manager", "accountant", "nurse", "teacher", "sales executive", "customer service", "warehouse operative", "mechanical engineer", "electrical engineer", "civil engineer", "HR manager", "__custom__" ], "type": "string", "description": "Pick a common role or choose 'Custom' and type your own below", "default": "software engineer" }, "custom_keyword": { "title": "Custom Keyword", "type": "string", "description": "Type your own search keyword here. Overrides the preset above when filled in." }, "location": { "title": "Location Preset", "enum": [ "London", "Manchester", "Birmingham", "Leeds", "Edinburgh", "Glasgow", "Bristol", "Liverpool", "Cardiff", "Belfast", "Cambridge", "Oxford", "Remote", "New York", "San Francisco", "Los Angeles", "Chicago", "Austin", "Seattle", "Washington DC", "Berlin", "Munich", "Paris", "Amsterdam", "Sydney", "Melbourne", "__custom__" ], "type": "string", "description": "Pick a common location or choose 'Custom' and type your own below", "default": "London" }, "custom_location": { "title": "Custom Location", "type": "string", "description": "Type your own location here. Overrides the preset above when filled in." }, "country": { "title": "Country / Region", "enum": [ "uk", "us", "de", "fr", "nl", "au", "remote" ], "type": "string", "description": "Target country for job search. Determines which boards are auto-selected and which proxy region to use.", "default": "uk" }, "max_results": { "title": "Max Results", "minimum": 100, "type": "integer", "description": "Maximum total job listings to return (spread across all boards). Minimum 100.", "default": 100 }, "unlimited": { "title": "Unlimited Mode", "type": "boolean", "description": "Scrape without a results cap. Results are saved as they come in, so you keep everything even if you stop the run early. Overrides Max Results.", "default": false }, "salary_min": { "title": "Minimum Salary", "type": "integer", "description": "Minimum annual salary filter (e.g. 30000, 50000, 75000). Leave empty for no filter." }, "job_type": { "title": "Job Type", "enum": [ "all", "permanent", "temporary", "contract", "part-time" ], "type": "string", "description": "Filter by employment type", "default": "all" }, "boards": { "title": "Job Boards to Scrape", "type": "array", "description": "Pick specific boards or leave empty to auto-select based on your chosen country.", "items": { "type": "string", "enum": [ "reed", "totaljobs", "cvlibrary", "cwjobs", "indeed", "findajob", "adzuna", "usajobs", "indeed_us", "indeed_de", "indeed_fr", "indeed_nl", "indeed_au", "remoteok", "arbeitnow" ], "enumTitles": [ "Reed (UK)", "Totaljobs (UK)", "CV-Library (UK)", "CWJobs (UK)", "Indeed UK", "GOV.UK Find a Job", "Adzuna (Multi-Country)", "USAJobs (US Gov)", "Indeed US", "Indeed Germany", "Indeed France", "Indeed Netherlands", "Indeed Australia", "RemoteOK (Global Remote)", "Arbeitnow (EU & Remote)" ] }, "default": [] }, "deduplicate": { "title": "Remove Duplicates", "type": "boolean", "description": "Remove duplicate jobs that appear on multiple boards", "default": true }, "salary_benchmark": { "title": "Include Salary Benchmarks", "type": "boolean", "description": "Output salary summary statistics (median, mean, p25, p75) alongside job listings", "default": false }, "adzuna_app_id": { "title": "Adzuna App ID", "type": "string", "description": "Optional: Adzuna API App ID (free at https://developer.adzuna.com)" }, "adzuna_app_key": { "title": "Adzuna App Key", "type": "string", "description": "Optional: Adzuna API App Key" } } }, "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 } } } } } } } } } }