Search Booli's `GET /api/booli/search` endpoint for homes for sale (till salu) in Swedish areas. Every card carries price, rooms, living area, floor, monthly fee, address, coordinates, agent, amenities and image URLs, so no second call is needed to render a result list. Filters are validated: an unknown filter name or value returns 422 instead of being ignored. Pages are disjoint and `total` is the full result count; `page * limit` may not exceed 35000. Booli's search also lists homes announced as soon for sale (`status.key` is `upcomingSale`), some without a price; send `upcoming_sale=0` to keep only active listings. Find area ids with `GET /api/booli/areas`.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
27 optional filters available.
string
Required
Comma-separated Booli area ids, for example 1 for Stockholm kommun. Find ids with /api/booli/areas
example
string
Optional
Sort key, one of published, listPrice, rooms, livingArea, rent, listSqmPrice, plotArea, postAddress. Defaults to published
relevance
boolean
Optional
true or false. Each sort key is published in specific directions only; an unpublished combination returns 422
true
integer
Optional
Page number, default 1. page * limit may not exceed 35000
1
integer
Optional
Results per page, default 35, maximum 100
10
string
Optional
Comma-separated list of: Lägenhet, Villa, Kedjehus-Parhus-Radhus, Fritidshus, Gård, Tomt/Mark
example
string
Optional
Comma-separated list of: hasBalconyOrPatio, hasFireplace, buildingHasElevator
example
string
Optional
One of: 1, 2, 3, 4, 5, 10, 15, 20, 25, 30, 50, 100
example
string
Optional
One of: bottomFloor, aboveBottomFloor, topFloor
example
string
Optional
One of: 1, 3, 7, 30
example
string
Optional
One of: todayOnwards, thisWeekend, nextSevenDays
example
string
Optional
One of: 500, 1000, 1500, 2000, 2500, 3000, 3500, 4000, 4500, 5000, 6000, 8000, 10000, 12000, 14000, 16000, 18000, 20000
example
string
Optional
One of: 100, 250, 500, 750, 1000
example
string
Optional
Comma-separated list of: priceDecrease, tenureOwnership
example
boolean
Optional
1, 0, true or false
true
boolean
Optional
1, 0, true or false
true
string
Optional
Number, for example 2.5
example
string
Optional
Number, for example 2.5
example
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
integer
Optional
Whole number
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
success
{
"data": {
"page": 1,
"cards": [],
"count": 10,
"limit": 10,
"total": 7943
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 404
The id, area or home does not exist. This response is not billable.
HTTP 422
A parameter or filter is missing or invalid. This response is not billable.
HTTP 503
Booli is temporarily unavailable. Retry the request. This response is not billable.
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.