Search properties
The FrontBooker Property Search API allows authorized applications to discover accommodation listings using supported search parameters, including destination, property characteristics and other available filters.
What the endpoint does
Returns structured property information and pagination metadata according to the application's permissions.
When developers should use it
Use this endpoint when building property discovery experiences, search interfaces, or destination browsing features.
Authentication requirements
Bearer token required: Authorization: Bearer fb_live_your_secret_key
Required parameters
destination— The destination to search (city, country, or region).
Optional parameters
limit— Number of results per page (default: 20).page— Page number for pagination.check_in— Check-in date.check_out— Check-out date.
Request example
GET /v1/search?destination=Nairobi&limit=5
Authorization: Bearer fb_live_your_secret_keyResponse schema
{
"success": true,
"data": {
"properties": [],
"pagination": {
"page": 1,
"has_more": true
}
}
}Error responses
- 401 — Unauthorized: Invalid or missing API key.
- 429 — Rate limited: Too many requests.
- 400 — Bad request: Missing or invalid parameters.
Rate limits
Rate limits are enforced per API credential. See /docs/rate-limits/ for details.