{ "openapi": "3.0.1", "info": { "title": "SEEK Jobs Scraper", "description": "Scrape public SEEK Australia and New Zealand jobs by keyword or direct URL. Includes filters, pagination, deduplication, salary and workplace data, optional descriptions, and residential fallback only when direct requests are blocked.", "version": "0.1", "x-build-id": "TPIOGFj7iaXsv4Z4R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~seek-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-seek-jobs-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/dami_studio~seek-jobs-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-seek-jobs-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/dami_studio~seek-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-seek-jobs-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": { "site": { "title": "SEEK site", "enum": [ "AU", "NZ" ], "type": "string", "description": "Search SEEK Australia or New Zealand.", "default": "AU" }, "keywords": { "title": "Keywords", "type": "string", "description": "Job title or search terms, for example software engineer or registered nurse." }, "location": { "title": "Location", "type": "string", "description": "City, region, or country. Leave blank for all locations." }, "jobUrls": { "title": "Direct job URLs", "type": "array", "description": "Public SEEK job URLs to fetch directly. Direct URLs are deduplicated with search results.", "items": { "type": "string" } }, "jobIds": { "title": "Direct job IDs", "type": "array", "description": "SEEK numeric job IDs to fetch directly.", "items": { "type": "string", "pattern": "^[0-9]+$" } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique job records returned.", "default": 50 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum pages to request. SEEK normally returns up to 22 jobs per page.", "default": 5 }, "datePosted": { "title": "Date posted", "enum": [ "any", "today", "3days", "7days", "14days", "30days" ], "type": "string", "description": "Optional client-side age filter.", "default": "any" }, "workTypes": { "title": "Employment types", "type": "array", "description": "Optional client-side employment type filters, such as Full time or Contract/temp.", "items": { "type": "string" } }, "workplaceTypes": { "title": "Workplace types", "type": "array", "description": "Optional client-side workplace filters: Remote, Hybrid, or On-site.", "items": { "type": "string" } }, "salaryMin": { "title": "Minimum salary", "minimum": 0, "type": "number", "description": "Optional minimum numeric salary filter when SEEK exposes salary data." }, "includeDetails": { "title": "Fetch descriptions", "type": "boolean", "description": "Fetch each job page and add description, requirements, and structured metadata. This uses more requests.", "default": false }, "useResidentialFallback": { "title": "Residential fallback", "type": "boolean", "description": "Allow residential proxy retries only after a direct request is blocked or rate-limited. Proxy usage can materially increase cost.", "default": true }, "proxyConfiguration": { "title": "Residential proxy", "type": "object", "description": "Apify proxy configuration used only for blocked direct requests. Residential is recommended for fallback.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxProxyRetries": { "title": "Proxy retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Maximum fresh residential sessions across the run after direct requests are blocked.", "default": 2 } } }, "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 } } } } } } } } } }