Search Locations

Endpoint

GET /locations/search

Description

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. This is a public endpoint.

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": 4521,
    "osm_id": 123456789,
    "name": "D-Marin Lefkas",
    "lat": 38.8335,
    "lon": 20.7068,
    "city": "Lefkada",
    "state": "Western Greece",
    "country": "Greece",
    "harbour_category": "marina"
  },
  {
    "id": 4523,
    "name": "Lefkas Town Quay",
    "lat": 38.8329,
    "lon": 20.7102,
    "city": "Lefkada",
    "state": "Western Greece",
    "country": "Greece",
    "harbour_category": "harbour"
  }
]

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