{ "openapi": "3.0.1", "info": { "title": "IrishJobs Ireland Vacancy Listings Scraper", "description": "Export public IrishJobs Ireland vacancy listings with job IDs, employers, locations, advertised salary text and posting timestamps. Use keyword/location searches or IrishJobs search URLs for recurring recruitment snapshots.", "version": "0.1", "x-build-id": "hStMWVVUTtXK6Ze0h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~irishjobs-vacancy-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-irishjobs-vacancy-listings-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/automation-lab~irishjobs-vacancy-listings-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-irishjobs-vacancy-listings-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/automation-lab~irishjobs-vacancy-listings-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-irishjobs-vacancy-listings-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", "properties": { "startUrls": { "title": "IrishJobs search URLs", "maxItems": 10, "type": "array", "description": "1–10 HTTPS www.irishjobs.ie/jobs/ search URL objects. Preserves URL filters and starting offset. Cannot combine with keyword or location. Detail URLs and other hosts are rejected. Duplicate URLs and job IDs are removed within this run.", "items": { "type": "object", "properties": { "url": { "title": "Search URL", "type": "string", "description": "HTTPS IrishJobs search URL" } }, "required": [ "url" ] } }, "keyword": { "title": "Search keyword", "maxLength": 100, "type": "string", "description": "IrishJobs upstream search terms, trimmed and converted to a URL slug; not a local exact-phrase filter. Source ranking may return related titles. Cannot combine with startUrls. Defaults to software developer when no search is supplied." }, "location": { "title": "Search location", "maxLength": 100, "type": "string", "description": "IrishJobs location slug, for example Dublin or Cork. Requires keyword and cannot combine with startUrls. Filtering is performed by IrishJobs, not by local substring matching; nearby results follow the site's behavior." }, "maxItems": { "title": "Maximum vacancy records", "minimum": 1, "maximum": 250, "type": "integer", "description": "Global cap on unique saved jobs across all search URLs, after job-ID deduplication. 1–250, default 20; zero is invalid. Stops when this cap, maxPages, source exhaustion, billing limit or timeout is reached. Does not guarantee this many results.", "default": 20 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "Global cap on successful search pages across all URLs, including their first pages; 1–10, default 2. Pages usually contain 25 jobs. Repeated jobs still consume a page; no unlimited setting. Increase with maxItems for larger snapshots.", "default": 2 }, "maxRequestRetries": { "title": "Transient request retries", "minimum": 0, "maximum": 2, "type": "integer", "description": "Additional attempts per page for network timeouts/resets and HTTP 408/425/429/5xx. 0–2, default 1. Challenge, malformed data and permanent HTTP errors fail immediately. No browser or residential proxy fallback.", "default": 1 } } }, "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 } } } } } } } } } }