{ "openapi": "3.0.1", "info": { "title": "Distressed Property Feed — EU Judicial Auctions", "description": "Aggregate distressed real estate signals across Belgium, Spain and France. Runs our Biddit (BE) and Subastas BOE (ES) judicial auction scrapers plus our BODACC (FR) insolvency registry scraper, normalized to one schema: source, country, sale date, reserve price, property type, address.", "version": "0.1", "x-build-id": "FabfLe8Xf0Hjoixzh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~distressed-property-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-distressed-property-feed", "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/studio-amba~distressed-property-feed/runs": { "post": { "operationId": "runs-sync-studio-amba-distressed-property-feed", "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/studio-amba~distressed-property-feed/run-sync": { "post": { "operationId": "run-sync-studio-amba-distressed-property-feed", "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": { "countries": { "title": "Countries", "type": "array", "description": "Which country sources to include. Leave all selected for the full feed.", "items": { "type": "string", "enum": [ "BE", "ES", "FR" ], "enumTitles": [ "Belgium (Biddit)", "Spain (Subastas BOE)", "France (BODACC)" ] } }, "beProvince": { "title": "Belgium: Province", "type": "string", "description": "Filter Biddit auctions by Belgian province. Leave empty for all provinces." }, "esProvince": { "title": "Spain: Province Code", "type": "string", "description": "Filter Subastas BOE auctions by province code. Examples: '28' Madrid, '08' Barcelona, '46' Valencia. Leave empty for all provinces." }, "frSearchQuery": { "title": "France: Company Name / Keyword", "type": "string", "description": "BODACC only supports company-name search, not free browsing. Default 'immobilier' surfaces real-estate agencies and holding companies (SCI) undergoing an insolvency-driven business sale — the closest proxy to a property-distress signal this registry exposes." }, "frDepartment": { "title": "France: Department Code", "type": "string", "description": "Optional. Restrict BODACC results to a French department. Example: '75' for Paris." }, "minReservePrice": { "title": "Minimum Reserve Price (EUR)", "minimum": 0, "type": "integer", "description": "Drop auction items with a reserve/appraisal price below this amount. Does not filter FR business-sale signal rows (they carry no price)." }, "maxReservePrice": { "title": "Maximum Reserve Price (EUR)", "minimum": 0, "type": "integer", "description": "Drop auction items with a reserve/appraisal price above this amount. Does not filter FR business-sale signal rows (they carry no price)." }, "enrichFrOwners": { "title": "Enrich FR items with owner company data", "type": "boolean", "description": "For BODACC rows, look up the owning company on Pappers (registered address, SIRET, activity, employee range) and attach it to the row. Adds one extra actor call per enriched row, capped by 'Max FR Enrichments'.", "default": false }, "maxFrEnrichments": { "title": "Max FR Enrichments", "minimum": 0, "maximum": 30, "type": "integer", "description": "Maximum number of BODACC rows to enrich via Pappers per run, most-recent first.", "default": 5 }, "maxItemsPerSource": { "title": "Max Items Per Source", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of items to pull from each country source.", "default": 20 }, "timeoutPerSourceSecs": { "title": "Timeout Per Source (seconds)", "minimum": 30, "maximum": 600, "type": "integer", "description": "Maximum time to wait for each underlying country scraper to finish. A slow or failing source is skipped after this and reported in the run summary rather than blocking the whole run.", "default": 150 }, "proxyConfiguration": { "title": "Proxy Configuration (override)", "type": "object", "description": "Optional override passed to every child scraper. Leave empty to let each country source use its own correct residential proxy (BE/ES/FR) automatically — the recommended default." } } }, "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 } } } } } } } } } }