⚓
Loading…
Loading…
All requests require a Trade plan API key passed as a Bearer token in the Authorization header.
searchAccess to GET /api/v1/boats (search endpoint)listingsAccess to GET /api/v1/boats/:id and price historybulkAccess to POST /api/v1/bulk (bulk export)*All scopes (enterprise plans)Trade plan: 1,000 requests/hour per API key. The X-RateLimit-Limit header is returned on every response. Exceeding the limit returns 429 Too Many Requests.
/api/v1/boatssearchSearch and filter the full boat inventory. Returns paginated results with all key fields. Supports full-text search via the q parameter.
| Name | Type | Required | Description |
|---|---|---|---|
category | string | Optional | Boat category: sailing_yacht, motor_yacht, narrowboat, rib, catamaran, etc. |
make | string | Optional | Partial match on manufacturer name (case-insensitive) |
model | string | Optional | Partial match on model name (case-insensitive) |
min_price | integer | Optional | Minimum asking price in listing currency |
max_price | integer | Optional | Maximum asking price in listing currency |
min_length | float | Optional | Minimum length overall in feet |
max_length | float | Optional | Maximum length overall in feet |
min_year | integer | Optional | Minimum year of manufacture |
max_year | integer | Optional | Maximum year of manufacture |
country | string | Optional | Partial match on location_country |
engine_type | string | Optional | Exact match: inboard, outboard, sail, electric |
q | string | Optional | Full-text search across listing title, make, model, description |
sort | string | Optional | newest (default), price_asc, price_desc, length_asc, length_desc, year_desc, oldest |
page | integer | Optional | Page number (default: 1) |
limit | integer | Optional | Results per page (default: 50, max: 100) |
curl -H "Authorization: Bearer bq_live_..." \ "https://boatquest.co.uk/api/v1/boats?category=sailing_yacht&min_price=50000&country=UK&sort=price_asc&limit=5"
{
"data": [
{
"id": "3f8a2b1c-...",
"make": "Beneteau",
"model": "Oceanis 40",
"year": 2008,
"length_overall_ft": 39.4,
"asking_price": 62000,
"currency": "GBP",
"price_gbp": 62000,
"price_percentile": 42,
"location_country": "United Kingdom",
"source_site": "yachtworld",
"first_seen_at": "2026-04-15T09:22:00Z",
"days_on_market": 18
}
],
"total": 1284,
"page": 1,
"per_page": 5,
"total_pages": 257
}The API uses standard REST conventions and works with any HTTP client. A Postman collection is available on request.