Returns paginated property listings. All query parameters are optional and can be combined.
| Parameter | Type | Description |
|---|
| location | string | Substring search on location, title, or postcode |
| min_price | number | Minimum price filter (inclusive) |
| max_price | number | Maximum price filter (inclusive) |
| bedrooms | number | Exact bedroom count |
| type | string | Substring match on property type (e.g. "flat", "detached") |
| page | number | Page number (default: 1) |
| limit | number | Results per page (default: 20, max: 100) |
Try it
{
"total": 201,
"page": 1,
"limit": 20,
"pages": 11,
"data": [ { ... }, { ... } ]
}
Health check — returns server status and total listing count.
Try it
{ "status": "ok", "listings_count": 201 }