{ "openapi": "3.0.1", "info": { "title": "Europe Distressed Property Scraper - Foreclosures & Auctions", "description": "Distressed-property leads across Europe: German ZVG foreclosure auctions, Polish KRZ restructuring proceedings, and Spanish BOE judicial auctions in one run, with detail enrichment, resume, and incremental change tracking.", "version": "1.0", "x-build-id": "sw5zdgPdorgDmhkly" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~distressed-eu-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-distressed-eu-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/abotapi~distressed-eu-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-distressed-eu-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/abotapi~distressed-eu-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-distressed-eu-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": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "How to discover records. 'search' walks the selected country lanes with your filters. 'url' reads only the links you paste into urls. Pasted links are ignored in search mode; the run log tells you when that happens.", "default": "search" }, "country": { "title": "Country lanes", "type": "array", "description": "Which registers to walk, in order. Germany = ZVG foreclosure auction portal. Poland = KRZ restructuring register (entity search). Spain = BOE judicial auctions. Each selected lane uses its own filters below.", "items": { "type": "string", "enum": [ "de", "pl", "es" ], "enumTitles": [ "Germany — ZVG foreclosure auctions", "Poland — KRZ restructuring proceedings", "Spain — BOE judicial auctions" ] }, "default": [ "de" ] }, "deLand": { "title": "DE: State (required)", "enum": [ "bw", "by", "be", "bb", "hb", "hh", "he", "mv", "ni", "nw", "rp", "sl", "sn", "st", "sh", "th" ], "type": "string", "description": "German federal state code for the foreclosure search: bw, by, be (Berlin), bb, hb, hh, he, mv, ni, nw, rp, sl, sn, st, sh, th. The portal requires one.", "default": "be" }, "deLands": { "title": "DE: States (multi-select, optional)", "type": "array", "description": "Search several German states in one run. Pick 'all' for all 16. When set, it replaces the single state above. The single-state field keeps working.", "items": { "type": "string", "enum": [ "all", "bw", "by", "be", "bb", "hb", "hh", "he", "mv", "ni", "nw", "rp", "sl", "sn", "st", "sh", "th" ], "enumTitles": [ "All 16 states", "Baden-Württemberg", "Bavaria", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hesse", "Mecklenburg-Vorpommern", "Lower Saxony", "North Rhine-Westphalia", "Rhineland-Palatinate", "Saarland", "Saxony", "Saxony-Anhalt", "Schleswig-Holstein", "Thuringia" ] } }, "deCourt": { "title": "DE: Court / place (optional)", "type": "string", "description": "Restrict to one court (Amtsgericht) of the selected state, by the town the portal lists, e.g. 'Charlottenburg' in Berlin or 'München' in Bavaria. Umlaut spellings (Köln, Koeln) both work. A name that matches no court is reported in the run log. Empty = whole state." }, "deObjectType": { "title": "DE: Object type (optional)", "enum": [ "", "grundstueck", "eigentuemer", "fwgel" ], "type": "string", "description": "Portal object-type token. Leave empty for all.", "default": "" }, "deStreet": { "title": "DE: Street (optional)", "type": "string", "description": "Street filter, e.g. 'Uhlandstraße'." }, "dePostalCode": { "title": "DE: Postal code (optional)", "type": "string", "description": "Postal code filter, e.g. '10717'." }, "deCity": { "title": "DE: City (optional)", "type": "string", "description": "City filter, e.g. 'Berlin'." }, "deAuctionType": { "title": "DE: Auction type (optional)", "enum": [ "", "-1", "0", "1", "2", "3", "4", "5", "6", "7", "8" ], "type": "string", "description": "Portal art selector: -1 = all, 0-8 = specific kinds of enforcement sale.", "default": "" }, "deAuctionDateFrom": { "title": "DE: Auction date from (optional)", "type": "string", "description": "Only auctions on/after this date. Format YYYY-MM-DD." }, "deAuctionDateTo": { "title": "DE: Auction date to (optional)", "type": "string", "description": "Only auctions on/before this date. Format YYYY-MM-DD." }, "deSort": { "title": "DE: Sort order", "enum": [ "2", "1", "3" ], "type": "string", "description": "Sort the foreclosure list: by auction date (default), by last update, or by case number.", "default": "2" }, "plEntityName": { "title": "PL: Entity name", "type": "string", "description": "Company (or other entity) name to search in the restructuring register, e.g. 'ALFA'. The register matches broadly; expect many results for short names." }, "plIdentifier": { "title": "PL: Identifier (KRS/NIP/PESEL)", "type": "string", "description": "Optional exact identifier to combine with the entity name: KRS or NIP for entities, PESEL for persons." }, "plCaseSignature": { "title": "PL: Case signature (optional)", "type": "string", "description": "Exact case signature (sygnatura) when you know it, e.g. 'III KRZ 12/26'. Results are limited without other filters." }, "plSoleTraderName": { "title": "PL: Sole trader business name (optional)", "type": "string", "description": "Firm name for sole traders with business activity (JDG)." }, "plFirstName": { "title": "PL: First name (optional)", "type": "string", "description": "First name of a natural person / sole trader." }, "plLastName": { "title": "PL: Last name (optional)", "type": "string", "description": "Last name of a natural person / sole trader (with first name)." }, "esAuctionStatus": { "title": "ES: Auction status", "enum": [ "", "EJ", "PU", "SU", "CA", "FS" ], "type": "string", "description": "Auction lifecycle filter. EJ = ongoing, PU = upcoming with bid, SU = without bid phase, CA = concluded/awarded... Leave empty for all.", "default": "EJ" }, "esDeadlineFrom": { "title": "ES: Deadline from (optional)", "type": "string", "description": "Auction conclusion date on/after this date. Format YYYY-MM-DD." }, "esDeadlineTo": { "title": "ES: Deadline to (optional)", "type": "string", "description": "Auction conclusion date on/before this date. Format YYYY-MM-DD." }, "esStartFrom": { "title": "ES: Start from (optional)", "type": "string", "description": "Auction start date on/after this date. Format YYYY-MM-DD." }, "esStartTo": { "title": "ES: Start to (optional)", "type": "string", "description": "Auction start date on/before this date. Format YYYY-MM-DD." }, "urls": { "title": "URLs", "type": "array", "description": "Pasted links to read in URL mode: a German foreclosure record page (index.php?button=showZvg&zvg_id=...&land_abk=...) or a Spanish auction page (detalleSubasta.php?idSub=SUB-..., any tab, with or without ver, also under /reg/). Several tabs of one auction return one record. Search form pages and Polish register links cannot be read from a link (use search mode); they are skipped with a warning. Left untouched, this field holds one example per supported shape.", "default": [ "https://www.zvg-portal.de/index.php?button=showZvg&zvg_id=14429&land_abk=be", "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-263220&ver=1" ], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Open each result's detail page (full description, attachments, parties, values). Adds one request per record; disable for fast listing-only runs.", "default": true }, "maxItems": { "title": "Max items", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Stop after this many results in total across all countries. Default 50; 0 = no limit (the German register alone holds thousands of auctions, so set a number you are happy to pay for).", "default": 50 }, "maxPages": { "title": "Max pages per search (0 = unlimited)", "minimum": 0, "type": "integer", "description": "Stop each search walk after this many result pages. 0 = walk until the natural end. Max items always applies too.", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Connection used for requests. Germany and Spain work with the standard pool; the Polish register needs residential exits (set automatically when the Poland lane is selected)." }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Continue a previous run: only records not already in that run's dataset are pushed. Leave empty for a fresh run." }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Track records across scheduled runs with the same scope: only NEW or UPDATED records are returned (UNCHANGED suppressed), and records that disappear are marked EXPIRED. Mutually exclusive with Resume.", "default": false }, "stateKey": { "title": "State key (optional)", "type": "string", "description": "Name for the incremental baseline when you want to share one baseline across different filter variants. Leave empty to derive it from the scope automatically." }, "emitUnchanged": { "title": "Emit unchanged records", "type": "boolean", "description": "In incremental mode, also return records that did not change (marked UNCHANGED).", "default": false }, "emitExpired": { "title": "Emit expired records", "type": "boolean", "description": "In incremental mode, also return records seen previously that no longer appear (marked EXPIRED).", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Advanced: record fields that should never count as a change (in addition to the built-in ignore list). Example: [\"updatedAt\"].", "items": { "type": "string" } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send a summary of each returned property to connected apps. Authorize a connector under Apify > Settings > Integrations, then select it here. Notion creates a page per record; other connectors receive a best-effort write or digest. Leave empty to skip. Dataset results are unaffected." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or ID of the Notion page where record pages should be created. Required for Notion; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of records written to each connector. Does not affect dataset output.", "default": 50 } } }, "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 } } } } } } } } } }