{ "openapi": "3.0.1", "info": { "title": "Hi Jobs (HIJOBS) Scraper: Scotland Highlands & Islands Jobs", "description": "Scrape hijobs.net Highlands and Islands jobs via the official mobile API. Extract salaries, locations, apply emails, and full descriptions without Cloudflare blocking. Supports direct search URL or filters, recency filter, and JSON or CSV output. Perfect for ATS syncing. $2 per 1,000 results.", "version": "0.1", "x-build-id": "FMW9kXEjXIWXNbnk4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~hijobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-hijobs-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/getascraper~hijobs-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-hijobs-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/getascraper~hijobs-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-hijobs-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": [ "enrichDetail", "onlyNewJobs" ], "properties": { "startUrls": { "title": "HIJOBS URLs", "type": "array", "description": "Any hijobs.net search, listing, facet, location, or direct job URL (e.g., https://hijobs.net/jobs/oban). If empty, the scraper will walk the job feed using the filters below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Keyword Search", "type": "string", "description": "Search jobs by keywords (e.g., 'support worker').", "default": "" }, "where": { "title": "Location Filter", "type": "string", "description": "Filter by city, town, or area (e.g., 'Inverness').", "default": "" }, "employerType": { "title": "Recruiter Type", "enum": [ "any", "charity-cic", "direct-employer", "agency" ], "type": "string", "description": "Filter by employer/recruiter type.", "default": "any" }, "hours": { "title": "Hours Filter", "enum": [ "any", "full-time", "part-time" ], "type": "string", "description": "Filter by hours (e.g. Full Time or Part Time).", "default": "any" }, "contractType": { "title": "Contract Type", "enum": [ "any", "permanent", "contract", "temporary", "volunteer" ], "type": "string", "description": "Filter by contract type.", "default": "any" }, "sort": { "title": "Sort Ordering", "enum": [ "added", "date", "salary", "relevance" ], "type": "string", "description": "Ordering of results returned by search API.", "default": "added" }, "enrichDetail": { "title": "Enrich Job Details", "type": "boolean", "description": "Fetch each unique job detail page to extract full description and contact email/application URLs.", "default": true }, "onlyNewJobs": { "title": "Only new jobs (Monitoring)", "type": "boolean", "description": "When enabled, first run builds a baseline of job IDs; later runs only save jobs not delivered before.", "default": false }, "resetSeenJobs": { "title": "Reset seen jobs", "type": "boolean", "description": "Clear the saved monitoring baseline at the start of this run.", "default": false }, "postedWithinHours": { "title": "Posted Within Hours (Recency)", "minimum": 0, "type": "integer", "description": "Only return jobs posted in the last N hours (e.g. 24 = last day).", "default": 0 }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of jobs to return (hard cap).", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. The mobile API is public and does not have anti-bot protections, so proxies are optional.", "default": { "useApifyProxy": 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 } } } } } } } } } }