{ "openapi": "3.0.1", "info": { "title": "Seek Job Scraper (AU & NZ) - Salary, Company + Full Advert", "description": "Search Seek Australia and Seek New Zealand by keyword and location for public job adverts: title, company, advertiser, location, work type, salary text, classification, listing date, teaser, bullet points and URL - plus the full advert body on request.", "version": "0.2", "x-build-id": "pfYbVIPmin8va7PQv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~seek-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-seek-jobs", "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/lanternlab318~seek-jobs/runs": { "post": { "operationId": "runs-sync-lanternlab318-seek-jobs", "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/lanternlab318~seek-jobs/run-sync": { "post": { "operationId": "run-sync-lanternlab318-seek-jobs", "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": [ "keywords" ], "properties": { "keywords": { "title": "Search keywords", "type": "array", "description": "One Seek search keyword per line, for example \"registered nurse\" or \"python developer\". Seek's own search syntax works, including quotes for an exact phrase. Every keyword is searched separately in the location below and its results are labelled with it. A job that matches several of your keywords is returned once and charged once.", "items": { "type": "string" } }, "site": { "title": "Seek site", "enum": [ "AU", "NZ" ], "type": "string", "description": "Which Seek to search: Australia (au.seek.com) or New Zealand (nz.seek.com). They are separate job boards - a run searches one of them, so run the Actor twice to cover both.", "default": "AU" }, "location": { "title": "Location", "type": "string", "description": "A location as Seek names it in its own search box: \"Sydney NSW\", \"All Melbourne VIC\", \"Brisbane QLD 4000\", \"Auckland\", \"Wellington\". Leave it empty for the whole country (\"All Australia\" or \"All New Zealand\"). A spelling Seek cannot match returns zero jobs rather than an error, and the keyword's status row shows the location Seek did match." }, "maxJobs": { "title": "Max jobs per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper bound on the rows one keyword may produce. Seek stops paging a search at 500 results whatever the page size, so 500 is the ceiling and a value above it does not reach more jobs - the keyword's status row then says resultDepthLimitReached, with jobsAvailable showing how many Seek claimed. Narrow the keyword or the location to reach past 500.", "default": 100 }, "includeDescription": { "title": "Include the full advert body", "type": "boolean", "description": "Also fetch each job's full advert text - one extra request per job, included in the price. Rows then carry description (the HTML Seek serves) and descriptionText (the same text with the tags removed). Leave it off for a much faster, lighter run: the teaser and bullet points still come from the search results. A job that expired between the search and the fetch gets description null with descriptionStatus \"not_found\".", "default": false }, "maxUpstreamRequests": { "title": "Max Seek requests", "minimum": 1, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Seek: search pages, advert-body fetches and retries together. At the ceiling collection stops - the keywords not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally. Leave empty and the Actor works a ceiling out from your keywords and limits, so a run is never unbounded." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Seek go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on; Seek's public search endpoint answers it without a bot check. Switch to residential, or to Australian exit IPs, only if searches start coming back blocked.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }