Search Locations

Endpoint

GET /locations/search

A location is an overnight stop — a marina, harbour, or anchorage where you can berth or drop anchor and spend the night aboard your boat. (Towns and regions aren't locations; they only appear as aggregated groupings.)

Fast typeahead search for locations (marinas, anchorages, bays). Uses normalized matching that handles special characters -- for example, searching "dalbora" matches "d'Albora Marina".

Returns a lightweight response suitable for autocomplete UIs.

Authentication

No authentication required for server-side requests — this is a public read endpoint. (A key is only needed for cross-origin calls made from a browser on another domain; see Authentication.)

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (minimum 2 characters)
`limit`	number	No	Max results (default: 10, max: 20)

Example Request

curl "https://charter.boats/api/locations/search?q=lefkas&limit=5"

Example Response

[
  {
    "id": 21166,
    "osm_id": -44514630,
    "name": "Split, MCI Marine Club International",
    "lat": 43.527441,
    "lon": 16.461807,
    "city": "Split",
    "state": null,
    "country": "Croatia",
    "harbour_category": "marina"
  },
  {
    "id": 12908,
    "osm_id": 244608718,
    "name": "ACI Marina Split",
    "lat": 43.5026218,
    "lon": 16.4307491,
    "city": "Split",
    "state": null,
    "country": "Croatia",
    "harbour_category": "marina"
  }
]

Response Fields

Field	Type	Description
`id`	number	Location ID
`osm_id`	number\|null	OpenStreetMap node ID
`name`	string	Location name
`lat`	number	Latitude
`lon`	number	Longitude
`city`	string\|null	City name
`state`	string\|null	State or region
`country`	string\|null	Country name
`harbour_category`	string\|null	Type of harbour (e.g. `marina`, `harbour`, `anchorage`)

Notes

Returns an empty array if q is missing or shorter than 2 characters.
Results are ranked by search relevance.

Search Locations

On this page