{ "openapi": "3.0.1", "info": { "title": "SEEK Job Scraper - Australia & New Zealand Job Listings", "description": "Scrape seek.com.au and seek.co.nz — SEEK's Australian and New Zealand job boards. Salary data, employer profiles, work type filters, and full job descriptions. Incremental mode detects new and changed listings. Compact output for AI agents and MCP workflows.", "version": "0.1", "x-build-id": "FuJkdo55zOihS1ihH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~seek-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-seek-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/blackfalcondata~seek-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-seek-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/blackfalcondata~seek-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-seek-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": { "query": { "title": "Search Query", "type": "string", "description": "Job search keywords (e.g. \"software engineer\", \"accountant\"). Use JSON array for multi-query." }, "country": { "title": "Country", "enum": [ "AU", "NZ" ], "type": "string", "description": "Which SEEK market to search.", "default": "AU" }, "location": { "title": "Location", "type": "string", "description": "City, state, or region (e.g. \"Sydney\", \"Melbourne VIC\"). Use JSON array for multi-location." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct SEEK search or job detail URLs. Overrides query/location.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Maximum total job listings to return. 0 = unlimited. Memory is auto-scaled by default (≤100 → 256 MB, ≤200 → 512 MB, 200+ → 1024 MB) but can be overridden manually in run settings.", "default": 50 }, "maxPages": { "title": "Max Pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum SERP pages to scrape per search source. Each page has ~22 jobs.", "default": 25 }, "sortMode": { "title": "Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort search results by relevance or date.", "default": "relevance" }, "dateRange": { "title": "Date Range", "enum": [ "", "1", "3", "7", "14", "31" ], "type": "string", "description": "Filter by posting date (SEEK date range code, e.g. \"1\" = last 24h, \"3\" = last 3 days, \"7\" = last 7 days, \"14\" = last 14 days, \"31\" = last 31 days)." }, "workType": { "title": "Work Type", "enum": [ "", "242", "243", "244", "245" ], "type": "string", "description": "Filter by employment type." }, "workArrangement": { "title": "Work Arrangement", "enum": [ "", "1", "2", "3" ], "type": "string", "description": "Filter by work arrangement." }, "includeDetails": { "title": "Include Detail Pages", "type": "boolean", "description": "Fetch each job's detail page for full description, structured location, salary data, company profile, and more.", "default": true }, "descriptionMaxLength": { "title": "Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate job description to N characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "Compact Output", "type": "boolean", "description": "Output only core fields (jobId, title, company, location, salary, category, URL, dates). Ideal for AI-agent and MCP workflows.", "default": false }, "incrementalMode": { "title": "Incremental Mode", "type": "boolean", "description": "Track changes between runs. Emits NEW, UPDATED, EXPIRED events. Requires stateKey.", "default": false }, "stateKey": { "title": "State Key", "type": "string", "description": "Stable identifier for the tracked search (e.g. \"au-software-sydney\"). Required when incrementalMode is true." }, "emitUnchanged": { "title": "Emit Unchanged Records", "type": "boolean", "description": "When incremental, also emit records that haven't changed since last run.", "default": false }, "emitExpired": { "title": "Emit Expired Records", "type": "boolean", "description": "When incremental, also emit records no longer found in search results.", "default": 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 } } } } } } } } } }