{ "openapi": "3.0.1", "info": { "title": "Portugal Property Auctions Scraper (Centro de Leilões)", "description": "Scrape centrodeleiloes.pt — Portuguese property auctions (judicial and insolvency): valor base, valor mínimo (85%) and valor de abertura (50%), court, date, address and PDF documents. Filter by district, type and value. Export to JSON/CSV/Excel.", "version": "0.1", "x-build-id": "avVJ6fNYGLrIuapef" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalflow~portugal-centro-leiloes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalflow-portugal-centro-leiloes", "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/signalflow~portugal-centro-leiloes/runs": { "post": { "operationId": "runs-sync-signalflow-portugal-centro-leiloes", "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/signalflow~portugal-centro-leiloes/run-sync": { "post": { "operationId": "run-sync-signalflow-portugal-centro-leiloes", "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": { "distrito": { "title": "Distrito", "type": "string", "description": "Optional district filter (partial match), e.g. 'Lisboa', 'Porto', 'Braga'.", "default": "" }, "concelho": { "title": "Concelho", "type": "string", "description": "Optional municipality filter (partial match), e.g. 'Sintra', 'Oeiras', 'Benavente'.", "default": "" }, "tipo": { "title": "Property Type", "enum": [ "all", "residential", "commercial", "land", "industrial", "other" ], "type": "string", "description": "Filter by property type. 'all' returns every auction type.", "default": "all" }, "tipo_processo": { "title": "Process Type", "enum": [ "all", "judicial", "insolvencia", "voluntaria" ], "type": "string", "description": "Filter by auction process type. Judicial = court-ordered; Insolvência = insolvency; Voluntária = voluntary.", "default": "all" }, "min_valor": { "title": "Minimum Base Value (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a base value above this amount. 0 = no limit.", "default": 0 }, "max_valor": { "title": "Maximum Base Value (€)", "minimum": 0, "type": "integer", "description": "Only return auctions with a base value below this amount. 0 = no limit.", "default": 0 }, "max_items": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of auctions to scrape. 0 = unlimited.", "default": 100 }, "download_pdf": { "title": "Download PDF documents", "type": "boolean", "description": "Save each auction PDF to permanent storage and return a stable URL, so the document is never lost even if the source link expires. On by default; turn off to only keep the original source links (slightly faster).", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The Actor automatically uses the Apify RESIDENTIAL proxy for HTML pages (the source throttles datacenter IPs) and the cheaper datacenter proxy for PDF downloads, to stay fast and low-cost. Residential usage is billed by Apify.", "default": { "useApifyProxy": true } }, "include_unpriced": { "title": "Include unscheduled/unpriced listings", "type": "boolean", "description": "Include listings with no price set yet. Off by default to avoid empty/N/A rows.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many auction detail pages to fetch in parallel. Higher = faster.", "default": 4 } } }, "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 } } } } } } } } } }