{ "openapi": "3.0.1", "info": { "title": "Boliga Scraper - Danish Property Listings", "description": "Scrape boliga.dk, Denmark's leading property portal. Search for-sale homes, apartments, and land by location, price, size, rooms, property type, and build year. Get price, address, specs, energy label, photos, and agent details.", "version": "1.0", "x-build-id": "cl4hi8ocOjwOwivGp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~boliga-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-boliga-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/crawlerbros~boliga-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-boliga-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/crawlerbros~boliga-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-boliga-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "sold", "byIds" ], "type": "string", "description": "What to fetch.", "default": "search" }, "zipCodes": { "title": "Postal codes (mode=search/sold)", "type": "array", "description": "Danish postal (zip) codes to search, e.g. `2100` (Copenhagen Ø), `8000` (Aarhus C), `5000` (Odense C). Leave empty together with Municipality/Street to search nationwide. For mode=sold, Boliga's sold-listings feed only supports server-side filtering by Municipality, not postal code -- postal-code filtering there is applied client-side over a bounded scan window, so pair it with Municipality for fast, complete results, or expect a slower/partial scan for a postal code alone.", "items": { "type": "string" } }, "municipality": { "title": "Municipality (mode=search/sold)", "enum": [ "101", "147", "151", "153", "155", "157", "159", "161", "163", "165", "167", "169", "173", "175", "183", "185", "187", "190", "201", "210", "217", "219", "223", "230", "240", "250", "253", "259", "260", "265", "269", "270", "306", "316", "320", "326", "329", "330", "336", "340", "350", "360", "370", "376", "390", "400", "410", "420", "430", "440", "450", "461", "479", "480", "482", "492", "510", "530", "540", "550", "561", "563", "573", "575", "580", "607", "615", "621", "630", "657", "661", "665", "671", "706", "707", "710", "727", "730", "740", "741", "746", "751", "756", "760", "766", "773", "779", "787", "791", "810", "813", "820", "825", "840", "846", "849", "851", "860" ], "type": "string", "description": "Restrict the search to one Danish municipality (kommune). Combines with postal codes / street if also set." }, "street": { "title": "Street name (mode=search/sold)", "type": "string", "description": "Restrict results to a specific street name, e.g. `Østerbrogade`. Combine with postal codes to narrow further." }, "estateIds": { "title": "Listing IDs (mode=byIds)", "type": "array", "description": "Boliga estate IDs to fetch full details for. Find the ID in any boliga.dk listing URL, e.g. `https://www.boliga.dk/bolig/2331454` -> `2331454`.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Min price (DKK)", "minimum": 0, "maximum": 200000000, "type": "integer", "description": "Only include listings priced at or above this amount, in Danish kroner. In mode=sold this filters on the final sale price." }, "maxPrice": { "title": "Max price (DKK)", "minimum": 0, "maximum": 200000000, "type": "integer", "description": "Only include listings priced at or below this amount, in Danish kroner. In mode=sold this filters on the final sale price." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Filter to specific property types (Boliga's own taxonomy). Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ], "enumTitles": [ "Villa", "Rækkehus (Townhouse)", "Ejerlejlighed (Apartment)", "Fritidshus (Summer house)", "Andelsbolig (Housing co-op)", "Landejendom (Farm / country property)", "Helårsgrund (Building plot)", "Fritidsgrund (Leisure plot)", "Villalejlighed (Villa apartment)", "Andet (Other)" ] }, "default": [] }, "minRooms": { "title": "Min rooms", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only include listings with at least this many rooms." }, "maxRooms": { "title": "Max rooms", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only include listings with at most this many rooms." }, "minSize": { "title": "Min size (m²)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Only include listings with a living area at or above this size in square meters." }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Only include listings with a living area at or below this size in square meters." }, "minBuildYear": { "title": "Min build year", "minimum": 1500, "maximum": 2100, "type": "integer", "description": "Only include listings built in or after this year." }, "maxBuildYear": { "title": "Max build year", "minimum": 1500, "maximum": 2100, "type": "integer", "description": "Only include listings built in or before this year." }, "sort": { "title": "Sort order (mode=search/sold)", "enum": [ "date-d", "date-a", "price-d", "price-a", "size-d", "size-a", "sqmprice-d", "sqmprice-a", "roi-d", "roi-a", "createdDate-d", "createdDate-a" ], "type": "string", "description": "How Boliga orders the results before the max-items cap is applied.", "default": "date-d" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of listings returned.", "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 } } }, "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 } } } } } } } } } }