Boligsiden Previews API Documentation List homes announced before they go on the market: approximate price, price per square metre, living and lot area with ranges, rooms, floors, build year, area, description, page views and the agency. Filters for location, address type, price, rooms and area are honoured.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
14 optional filters available.
string
Optional
One or more 4-digit Danish zip codes separated by commas. Example: 2100,2200.
example
string
Optional
One or more city names exactly as shown by the locations endpoint (display name such as Aarhus C, not the slug). Separate with commas or send cities[]=A&cities[]=B.
example
string
Optional
One or more municipality slugs such as aarhus or koebenhavn. Use the reference endpoint with type=municipalities.
example
string
Optional
One or more province slugs such as nordjylland. Use the reference endpoint with type=provinces.
example
string
Optional
Comma separated list (rows of other types are removed from the page and counted in meta.excluded_by_type_filter): villa, terraced house, condo, holiday house, allotment, cooperative, farm, full year plot, holiday plot, villa apartment, cattle farm, pig farm, plant farm, forest, hobby farm, special, houseboat, garage, parking, business, double house, multiple family house, room.
example
integer
Optional
Minimum price in DKK.
10
integer
Optional
Maximum price in DKK.
10
integer
Optional
Minimum number of rooms.
10
integer
Optional
Minimum living area in square metres.
10
integer
Optional
Maximum living area in square metres.
10
string
Optional
created_at, living_area, lot_area, price, price_per_area, zip_code or rooms.
example
boolean
Optional
true or false. Used with sort_by. Defaults to true.
true
integer
Optional
Page number, starting at 1. Page times page size must not exceed 10000. Defaults to 1.
1
integer
Optional
Rows per page, 1 to 100. Defaults to 20.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"meta": {
"page": 1,
"has_more": true,
"per_page": 20,
"total_hits": 1220,
"total_pages": 16
},
"results": [
{
"id": "5c95cc4a-0db3-4666-9f73-082498cbc02d",
"url": "https://www.edc.dk/ejendomsmaegler/skagen/poul-erik-bech",
"area": 66,
"city": "Skagen",
"price": 2695000,
"rooms": 4,
"title": "Prisvenligt og velholdt sommerhus i Gammel Skagen \u2013 t\u00e6t p\u00e5 strand og solnedgang",
"floors": 1,
"status": "open",
"realtor": {
"id": "791ba94d-a960-4f1c-a59d-eaeba6ac76ee",
"cvr": "18215101",
"name": "EDC Poul Erik Bech",
"slug": "edc-poul-erik-bech-sct.-laurentii-vej-63c-9990-skagen-791ba94da9604f1ca59deaeba6ac76ee",
"email": "999@edc.dk",
"phone": "98441616",
"rating": {
"buyer": {
"score": 9.13,
"responses": 8
},
"seller": {
"score": 9.57,
"responses": 7
}
},
"address": {
"city": "Skagen",
"road": "Sct. Laurentii Vej",
"floor": "st",
"zip_code": 9990,
"house_number": "63C"
},
"image_url": "https://images.boligsiden.dk/images/realtor_image/791ba94d-a960-4f1c-a59d-eaeba6ac76ee/1440x960/88cebef4-5c9b-4fa7-a222-65ca71f04538.webp?h=a35c1846641d261f37146093a9d84d18b0d3494a8e06b0a7a1ffb5bbfc966ce6",
"branch_name": "EDC",
"active_listings": {
"for_rent": 0,
"for_sale": 68,
"cooperative": 0
}
},
"latitude": 57.46252,
"lot_area": 900,
"province": "Nordjylland",
"zip_code": 9990,
"longitude": 10.4148445,
"area_range": {
"max": 75
},
"page_views": 15,
"year_built": 1984,
"description": "Attraktivt og velholdt sommerhus t\u00e6t p\u00e5 stranden i Gammel Skagen\n\nI det eftertragtede Gammel Skagen finder I dette hyggelige og velholdte sommerhus p\u00e5 66 m\u00b2, be...",
"address_type": "holiday house",
"municipality": "Frederikshavn",
"lot_area_range": {
"max": 1200,
"min": 750
},
"price_per_area": 40833,
"year_built_range": {
"max": 2000,
"min": 1980
},
"price_per_area_range": {
"max": 41000,
"min": 40500
}
}
]
},
"meta": {
"billable": true,
"endpoint_family": "previews"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. No upstream request is made. This response is not billable.
{
"errors": {
"per_page": [
"The page size must be 100 or fewer rows per page."
]
},
"message": "The request validation failed"
}Service Unavailable
Boligsiden could not be reached, blocked or rate limited every attempt, or answered with a shape that no longer matches the documented contract. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "previews"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Boligsiden API is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.