{ "openapi": "3.0.1", "info": { "title": "Boligsiden Property Scraper (Denmark)", "description": "Scrapes houses and apartments for sale from Boligsiden.dk, Denmark's #1 property portal. Search nationwide or by kommune (municipality); returns price, full address, coordinates, rooms, area, energy label and agent from a single search call.", "version": "0.1", "x-build-id": "rzZcQTk1nlqeXsF0y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~boligsiden-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-boligsiden-properties-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/scrapyx~boligsiden-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-boligsiden-properties-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/scrapyx~boligsiden-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-boligsiden-properties-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": { "kommunes": { "title": "Kommunes (municipalities) to search", "type": "array", "description": "Danish kommune (municipality) slugs, e.g. 'koebenhavn', 'aarhus', 'odense' -- one search per entry, each with its own SEARCH_SUMMARY row. Leave empty to search the whole country as a single query (43,000+ listings nationwide, capped by Max pages/Max properties below). An unrecognised kommune slug is reported as kommuneResolved=false rather than silently returning the national baseline.", "default": [], "items": { "type": "string" } }, "includePropertyDetails": { "title": "Fetch listing detail pages", "type": "boolean", "description": "Also fetch each listing's detail page for the free-text description, which is not present in search results. Costs one extra request per listing. Off by default because search results already carry price, full address, coordinates, rooms, area, energy label and the listing agent.", "default": false }, "maxItems": { "title": "Max properties per search", "minimum": 0, "type": "integer", "description": "Stop paginating a search after this many properties. Set to 0 for unlimited (still bounded by Max pages).", "default": 100 }, "maxPages": { "title": "Max pages per search", "minimum": 1, "type": "integer", "description": "Hard cap on pagination depth, independent of maxItems. Boligsiden pages honestly (a page past the real end answers a genuinely empty list, not a repeat/clamp), so this is purely a cost guard for very large searches (50 listings/page).", "default": 20 }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 12, "type": "integer", "description": "Upper bound on requests in flight at once, across searches and detail fetches. This target showed no bot-mitigation gate in recon, so this can be raised more freely than most actors in this portfolio.", "default": 5 }, "minRequestInterval": { "title": "Minimum seconds between request starts", "minimum": 0, "type": "integer", "description": "Paces request starts (not held inside a concurrency slot) rather than raw concurrency. Kept small by default as a courtesy -- no request-velocity sensitivity was observed for this target.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "No WAF or bot-mitigation gate was observed for Boligsiden.dk (7 TLS profiles x 2 surfaces, all clean). Residential proxy pinned to Denmark is still the default as this portfolio's standard baseline for a single-country public site.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DK" } } } }, "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 } } } } } } } } } }