{ "openapi": "3.0.1", "info": { "title": "Emprego SAPO Scraper – Portugal Jobs", "description": "Scrape job listings from emprego.sapo.pt — Portugal's leading job board. Extracts employment type, work model, and detailed descriptions from each listing page. Incremental tracking surfaces only new and changed listings on each run. Filters by district and work hours.", "version": "0.1", "x-build-id": "EUdgcm7ceyz1VX1kI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~emprego-sapo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-emprego-sapo-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~emprego-sapo-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-emprego-sapo-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~emprego-sapo-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-emprego-sapo-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. Leave empty to return all listings." }, "location": { "title": "District", "type": "string", "description": "Portuguese district slug to filter by (e.g. lisboa, porto, braga, setubal). Leave empty for all districts." }, "workHours": { "title": "Work Hours", "enum": [ "", "full-time", "part-time" ], "type": "string", "description": "Filter by work hours type.", "default": "" }, "sortOrder": { "title": "Sort Order", "enum": [ "mais-recentes", "relevancia", "mais-antigas", "nome-a-z", "nome-z-a" ], "type": "string", "description": "Order in which to return results.", "default": "mais-recentes" }, "daysOld": { "title": "Days Old", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only return jobs published within the last N days. 0 = no limit.", "default": 0 }, "maxResults": { "title": "Max Results", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Maximum total results (0 = unlimited, up to 9999).", "default": 25 }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Fetch full job details from each listing page (full description, validThrough, educationLevel, experienceLevel). Doubles request count.", "default": true }, "descriptionMaxLength": { "title": "Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N characters. 0 = no truncation.", "default": 0 }, "compact": { "title": "Compact Output", "type": "boolean", "description": "Return only core fields (jobId, title, company, location, salary, url, postedAt).", "default": false }, "incrementalMode": { "title": "Incremental Mode", "type": "boolean", "description": "Only emit NEW, UPDATED, and EXPIRED jobs relative to a prior run. Requires stateKey.", "default": false }, "stateKey": { "title": "State Key", "type": "string", "description": "Unique key to persist incremental state across runs (e.g. 'my-portugal-feed'). Required when incrementalMode is true." }, "emitUnchanged": { "title": "Emit Unchanged", "type": "boolean", "description": "Also emit UNCHANGED jobs (not just NEW/UPDATED/EXPIRED). Only applies when incrementalMode is true.", "default": false }, "emitExpired": { "title": "Emit Expired", "type": "boolean", "description": "Also emit jobs that disappeared since the last run (changeType=EXPIRED). Only applies when incrementalMode is true.", "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 } } } } } } } } } }