{ "openapi": "3.0.1", "info": { "title": "Totaljobs & CWJobs Scraper — UK Jobs & Salaries, No Phones", "description": "UK jobs from Totaljobs and CWJobs: title, company, location, salary as text and as min/max/period, contract type, posted date and the full job ad. No recruiter names or phones.", "version": "0.1", "x-build-id": "pJsuLT0GsNZrDdohP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~totaljobs-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-totaljobs-jobs", "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/highbrow_fame~totaljobs-jobs/runs": { "post": { "operationId": "runs-sync-highbrow_fame-totaljobs-jobs", "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/highbrow_fame~totaljobs-jobs/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-totaljobs-jobs", "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": { "searchUrls": { "title": "Search links", "type": "array", "description": "Set up a search on totaljobs.com or cwjobs.co.uk with all the filters you want and paste the address of the results page. One per line.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Or search here without a link: job titles or keywords (nurse, python developer, HGV driver). One search per line; the place and filters below apply to each.", "items": { "type": "string" } }, "location": { "title": "Place", "type": "string", "description": "A town, city, postcode or county (Leeds, M1, Kent). Empty: the whole UK. With a place and no keywords, you get every job there." }, "site": { "title": "Site", "enum": [ "totaljobs", "cwjobs" ], "type": "string", "description": "Which site the keywords search. CWJobs is Totaljobs' sister site for IT and tech jobs. A link decides this itself.", "default": "totaljobs" }, "radiusMiles": { "title": "Radius (miles)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Optional: jobs this far around the place — 0, 5, 10, 20 or 30 miles; other numbers round up. The site's default is 10." }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "maximum": 14, "type": "integer", "description": "Optional: only jobs from the last 1, 3, 7 or 14 days; other numbers round up. 0: any date.", "default": 0 }, "jobType": { "title": "Job type", "enum": [ "any", "permanent", "contract", "temporary", "part-time", "work-from-home" ], "type": "string", "description": "Optional.", "default": "any" }, "companyType": { "title": "Posted by", "enum": [ "any", "direct-employer", "agency" ], "type": "string", "description": "Optional: only jobs posted by the employer itself, or only by recruitment agencies.", "default": "any" }, "sortBy": { "title": "Sort", "enum": [ "relevance", "newest" ], "type": "string", "description": "For the keywords above.", "default": "relevance" }, "includeRelatedJobs": { "title": "Include related jobs", "type": "boolean", "description": "The site adds a few related jobs after the ones that match the keyword and counts them in its result number. Untick to keep only the jobs that match the keyword; the field match says which is which.", "default": true }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops each search after this many jobs.", "default": 200 }, "includeDetails": { "title": "Open every job ad", "type": "boolean", "description": "Adds the full job ad as plain text, the contract type (permanent, contract, temporary), whether the work is on-site, hybrid or remote, full or part time, industry and the date the ad runs until. One more page per job, so slower.", "default": false }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches to work on at the same time.", "default": 3 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Totaljobs and CWJobs turn away requests from data centres (Apify's own servers and its datacenter proxy both got HTTP 403 or no answer), so the run goes through UK residential proxies.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }