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_key

Response 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.