{ "openapi": "3.0.1", "info": { "title": "JobServe Scraper — UK IT & Contract Jobs, No Phones", "description": "UK IT, engineering and contract jobs from JobServe: title, agency or employer, location, day rate or salary with min/max/period and IR35, job type, dates, and the full ad if you want. No phones.", "version": "0.1", "x-build-id": "hMswQX7mLtbwXJZRX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/highbrow_fame~jobserve-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-highbrow_fame-jobserve-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~jobserve-jobs/runs": { "post": { "operationId": "runs-sync-highbrow_fame-jobserve-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~jobserve-jobs/run-sync": { "post": { "operationId": "run-sync-highbrow_fame-jobserve-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": "Run a search on jobserve.com with the filters you want and paste the address of the results page (…/JobSearch.aspx?shid=…). One per line. JobListing.aspx?q=…&lq=… links and JobServe's \"…-jobs-in-…\" pages work too.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Or search here without a link: skills or job titles (java developer, SAP, \"project manager\"). JobServe's own search syntax works (and, or, not, quotes). Each keyword is searched in each place below, or in the whole UK when there is no place. The filters below apply.", "items": { "type": "string" } }, "locations": { "title": "Places", "type": "array", "description": "UK towns, counties, regions or postcodes (Manchester, Kent, Scotland, EC2A), one per line. When several towns share a name, add the county after a comma: \"Newport, Gwent\". A place without keywords gives all its jobs.", "items": { "type": "string" } }, "maxListingsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stops each search after this many jobs.", "default": 200 }, "radius": { "title": "Distance", "enum": [ "1", "5", "10", "15", "25", "50", "75", "100" ], "type": "string", "description": "For towns and postcodes: how far around them, as on JobServe.", "default": "50" }, "postedWithinDays": { "title": "Posted within", "enum": [ "7", "6", "5", "4", "3", "2", "1", "0" ], "type": "string", "description": "JobServe searches the jobs of the last 7 days at most.", "default": "7" }, "jobType": { "title": "Job type", "enum": [ "any", "permanent", "contract", "contract-or-permanent", "part-time-temporary" ], "type": "string", "description": "Optional. JobServe counts \"contract or permanent\" jobs as contracts too.", "default": "any" }, "remoteOnly": { "title": "Remote working only", "type": "boolean", "description": "Optional: only jobs JobServe marks as remote working.", "default": false }, "postedBy": { "title": "Posted by", "enum": [ "any", "agency", "employer" ], "type": "string", "description": "Optional: recruitment agencies (JobServe's \"employment business\" and \"employment agency\") or direct employers. Applied to search links too.", "default": "any" }, "includeDetails": { "title": "Full ad for the first 50 jobs", "type": "boolean", "description": "Off by default. Adds the full job description, JobServe's job number, the closing date, region and country for the first 50 jobs of the run (JobServe limits how many job pages one IP address may open — see the README); the other jobs come with their list fields. Sentences that name a recruiter are taken out of the ad by rules.", "default": false }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many searches to work on at the same time. All of them share one polite pace towards JobServe.", "default": 2 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used only when a request fails on the network: the first try goes out directly.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }