{ "openapi": "3.0.1", "info": { "title": "Auctions Radar: Bank, Court & Government Auctions, Scored", "description": "Foreclosure, court and bank auctions from Germany, Spain, Italy and India in one format: price, valuation, debts, area, possession, dates, documents and photos. Every lot scored against similar lots and your budget, place and dates; price history and alerts.", "version": "0.1", "x-build-id": "CneOvVOIpgbeiLvtT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tacps126~auctions-radar/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tacps126-auctions-radar", "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/tacps126~auctions-radar/runs": { "post": { "operationId": "runs-sync-tacps126-auctions-radar", "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/tacps126~auctions-radar/run-sync": { "post": { "operationId": "run-sync-tacps126-auctions-radar", "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": "Auction portals to read. Each is the official public source for its country.", "items": { "type": "string", "enum": [ "DE", "ES", "IT", "IN" ], "enumTitles": [ "Germany: court foreclosures", "Spain: national auction portal (courts, tax agency)", "Italy: court-ordered sales", "India: public-sector bank e-auctions" ] }, "default": [ "DE", "ES", "IT", "IN" ] }, "assetTypes": { "title": "Asset types", "type": "array", "description": "Empty = all property and vehicles.", "items": { "type": "string", "enum": [ "apartment", "house", "commercial", "industrial", "land", "agricultural", "parking", "vehicle", "other" ], "enumTitles": [ "Apartments", "Houses", "Shops and offices", "Industrial and warehouses", "Land and plots", "Farmland", "Garages and parking", "Vehicles", "Other goods" ] } }, "regions": { "title": "States, provinces or regions", "type": "array", "description": "Names as used locally or in English, e.g. Bayern, Berlin, Madrid, Malaga, Lombardia, Kerala, Maharashtra. Narrows the portals' own searches, so more of the matching lots are read.", "items": { "type": "string" } }, "location": { "title": "Town, postcode or address", "type": "string", "description": "E.g. Milano, 10629, Pune. Alone it matches the lot's address; with a radius it is the centre." }, "radiusKm": { "title": "Radius (km)", "minimum": 0.5, "maximum": 1000, "type": "number", "description": "Only lots within this distance of the town or postcode above. Lots without a known position are left out." }, "budgetMin": { "title": "Budget from", "minimum": 0, "type": "number", "description": "Lowest total cost (price plus debts that pass to the buyer)." }, "budgetMax": { "title": "Budget up to", "minimum": 0, "type": "number", "description": "Highest total cost (price plus debts that pass to the buyer)." }, "budgetCurrency": { "title": "Budget currency", "enum": [ "EUR", "INR", "USD", "GBP", "CHF", "AUD", "CAD", "SGD", "JPY" ], "type": "string", "description": "Prices in other currencies are converted with the European Central Bank's daily reference rates.", "default": "EUR" }, "budgetFlex": { "title": "Budget flexibility", "minimum": 0, "maximum": 1, "type": "number", "description": "Share a lot may be outside the budget and still be shown (scored lower), e.g. 0.1 for 10%.", "default": 0 }, "minAreaSqm": { "title": "Min area (m²)", "minimum": 0, "type": "number", "description": "Lots with a known smaller area are left out." }, "maxAreaSqm": { "title": "Max area (m²)", "minimum": 0, "type": "number", "description": "Lots with a known larger area are left out." }, "auctionWithinDays": { "title": "Auction within N days", "minimum": 1, "maximum": 730, "type": "integer", "description": "Only lots whose bidding closes in the next N days." }, "minDaysLeft": { "title": "Min days left", "minimum": 0, "maximum": 60, "type": "number", "description": "Leave out lots closing sooner than this, too late to prepare a bid (Italian offers are due the day before the sale). 0 keeps all.", "default": 1 }, "vacantOnly": { "title": "Vacant only", "type": "boolean", "description": "Only lots stated as vacant, or in the bank's physical possession.", "default": false }, "keywords": { "title": "Must mention", "type": "array", "description": "Any of these words in the title or description, e.g. garden, terrace, garage.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not mention", "type": "array", "description": "Leave out lots that mention any of these words, e.g. share, usufruct.", "items": { "type": "string" } }, "profile": { "title": "Scoring profile", "enum": [ "balanced", "bargainHunter", "lowRisk", "quickDeal" ], "type": "string", "description": "What matters most when ranking.", "default": "balanced" }, "weights": { "title": "Custom weights", "type": "object", "description": "Optional weight per signal, replacing the profile's: pricePerSqm, price, discount, reserveCut, possession, clearTitle, information, timing, deposit, financing, year, mileage, condition. 0 switches one off, e.g. {\"pricePerSqm\": 4, \"possession\": 3}." }, "fitWeight": { "title": "Weight of your requirements", "minimum": 0, "maximum": 1, "type": "number", "description": "Share of the score that measures fit to your budget, radius and area (the rest is the lot's quality against similar lots).", "default": 0.3 }, "sortBy": { "title": "Sort by", "enum": [ "score", "auctionDate", "price", "pricePerSqm", "discount" ], "type": "string", "description": "Order of the results.", "default": "score" }, "maxItems": { "title": "Max lots", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most lots returned, best first.", "default": 100 }, "scanPerSource": { "title": "Lots read per country", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many lots each portal is read for before scoring. More gives a better comparison and takes longer; only returned lots are charged.", "default": 300 }, "includeUnscheduled": { "title": "Include lots without a date", "type": "boolean", "description": "India: also bank listings that have no auction date set yet.", "default": false }, "saleHistory": { "title": "Earlier sale attempts", "type": "boolean", "description": "Italy: look up the court's earlier attempts to sell each lot and the price cuts since.", "default": true }, "onlyNew": { "title": "Only new lots", "type": "boolean", "description": "Each run returns only lots that earlier runs with the same search did not deliver.", "default": false }, "changesOnly": { "title": "Changes only", "type": "boolean", "description": "Return only lots that are new or whose price, status or date changed since the last run, with the old and new values. Schedule it to catch price cuts.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional name for the history, so several monitors can run side by side. Setting one also keeps each lot's price history." }, "tenantId": { "title": "Tenant ID", "type": "string", "description": "Optional label used to keep separate histories for different clients or teams." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave as is unless runs are refused.", "default": { "useApifyProxy": false } }, "aiInsights": { "title": "AI insights", "type": "boolean", "description": "Add an `insight` to each lot: deal rating at the current bid, risks to check and a note on a sensible maximum bid; with a profile, how well it fits you.", "default": false }, "aiProfile": { "title": "Your profile (for the fit score)", "type": "string", "description": "What you buy, e.g. \"Investor in Bavaria, buys vacant flats under 250,000 EUR to rent out\". Adds a fit score." }, "aiLanguage": { "title": "Insight language", "type": "string", "description": "Insights are written in this language, whatever the source language.", "default": "English" }, "maxInsights": { "title": "Max insights per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Insights are added to the first N lots (in the sort order).", "default": 25 }, "aiProvider": { "title": "AI provider", "enum": [ "apify", "anthropic", "openai", "gemini", "openrouter", "groq", "mistral", "deepseek", "compatible" ], "type": "string", "description": "Which AI does the analysis. Apify needs no key: the model's tokens are billed to your Apify account by Apify's AI gateway (a fraction of a cent per call with the default model). Any other provider uses your own key and bills you there.", "default": "apify" }, "aiApiKey": { "title": "AI API key", "type": "string", "description": "Your own key for the provider above (not needed for Apify). Sent only to that provider, never stored." }, "aiModel": { "title": "AI model", "type": "string", "description": "Model name. Apify: an OpenRouter id like anthropic/claude-sonnet-... or google/gemini-... (default: the newest Claude Haiku listed, a light model since it runs once per result). Anthropic: default claude-opus-5-5. Others: required." }, "aiBaseUrl": { "title": "API base URL", "type": "string", "description": "Only for \"Other OpenAI-compatible API\", e.g. http://localhost:11434/v1 for Ollama." }, "debug": { "title": "Debug", "type": "boolean", "description": "Save extra diagnostics with the run (for support requests).", "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 }, "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 } } } } } } } } } }