{ "openapi": "3.0.1", "info": { "title": "UK Visa Sponsor Jobs", "description": "UK jobs from Reed's official API, each checked against the Home Office register of licensed visa sponsors and tagged for what the ad says about sponsorship, with the exact sentence. Monitoring mode: pay only for new jobs.", "version": "0.1", "x-build-id": "3GS4yHLcyXvyGWSI6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/quietbyte~reed-jobs-uk-visa/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-quietbyte-reed-jobs-uk-visa", "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/quietbyte~reed-jobs-uk-visa/runs": { "post": { "operationId": "runs-sync-quietbyte-reed-jobs-uk-visa", "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/quietbyte~reed-jobs-uk-visa/run-sync": { "post": { "operationId": "run-sync-quietbyte-reed-jobs-uk-visa", "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": { "keywords": { "title": "Keywords", "type": "string", "description": "What to search for on Reed, e.g. \"software engineer\" or \"nurse\". Reed's own search syntax." }, "location": { "title": "Location", "type": "string", "description": "A UK town, city or postcode, e.g. \"Manchester\". Leave empty for the whole UK." }, "distanceMiles": { "title": "Distance from location (miles)", "minimum": 0, "type": "integer", "description": "Search radius around the location. Reed's default is 10.", "default": 10 }, "minimumSalary": { "title": "Minimum salary (GBP)", "minimum": 0, "type": "integer", "description": "Optional." }, "maximumSalary": { "title": "Maximum salary (GBP)", "minimum": 0, "type": "integer", "description": "Optional." }, "postedByDirectEmployer": { "title": "Direct employers only", "type": "boolean", "description": "Keep this on for meaningful sponsor checks: with agency ads, the advertiser is the agency, not the employer.", "default": true }, "postedByRecruitmentAgency": { "title": "Recruitment agencies only", "type": "boolean", "description": "Only ads posted by recruitment agencies.", "default": false }, "permanent": { "title": "Permanent", "type": "boolean", "description": "Only permanent jobs.", "default": false }, "contract": { "title": "Contract", "type": "boolean", "description": "Only contract jobs.", "default": false }, "temp": { "title": "Temporary", "type": "boolean", "description": "Only temporary jobs.", "default": false }, "fullTime": { "title": "Full-time", "type": "boolean", "description": "Only full-time jobs.", "default": false }, "partTime": { "title": "Part-time", "type": "boolean", "description": "Only part-time jobs.", "default": false }, "graduate": { "title": "Graduate jobs", "type": "boolean", "description": "Only graduate jobs.", "default": false }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 0, "type": "integer", "description": "Keep jobs posted in the last N days. 0 = no limit.", "default": 0 }, "visaFilter": { "title": "Visa sponsorship in the ad", "enum": [ "any", "offered", "not_refused" ], "type": "string", "description": "Filter on what the ad says: offered = sponsorship offered (or mixed), not_refused = drop ads that rule it out.", "default": "any" }, "checkSponsorLicence": { "title": "Check the UK sponsor register", "type": "boolean", "description": "Match each employer against the Home Office Register of Licensed Sponsors. It describes the employer, not the job.", "default": true }, "sponsorFilter": { "title": "Only licensed sponsors", "enum": [ "any", "licensed" ], "type": "string", "description": "Keep only employers holding a UK sponsor licence. Turns the register check on.", "default": "any" }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Turn off for smaller output; the tags are still computed from the full ad.", "default": true }, "maxJobs": { "title": "Max jobs", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many jobs are saved.", "default": 200 }, "onlyNewJobs": { "title": "Only new jobs (monitoring mode)", "type": "boolean", "description": "Save only jobs not seen in earlier runs with the same settings, so scheduled runs pay for new jobs only. The first run counts every job as new.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Runs with the same name share one memory of seen jobs, even if other settings change." }, "reedApiKey": { "title": "Your Reed API key (optional)", "type": "string", "description": "Optional. A built-in key is used by default; add your own free key from reed.co.uk/developers for heavy use." } } }, "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 } } } } } } } } } }