Search Locations (AI)

GET/ai/locations

Search for charter bases, marinas, islands, and cities. Uses normalized matching that handles diacritics and special characters. Returns locations with boat counts.

Authentication

No authentication required. Rate limited to 60 requests per 10 minutes.

Query Parameters

Parameter	Type	Required	Description
`q`	string	Yes	Search query (minimum 2 characters). Marina name, city, island, or country.
`limit`	integer	No	Max results (default: 5, max: 20)

Request

curl "https://charter.boats/api/ai/locations?q=Lefkada&limit=10"

Response

{
  "locations": [
    {
      "id": 4521,
      "name": "D-Marin Lefkas",
      "city": "Lefkada",
      "country": "Greece",
      "type": "marina",
      "lat": 38.8335,
      "lon": 20.7068,
      "boat_count": 45,
      "url": "https://charter.boats/locations/4521"
    },
    {
      "id": 4523,
      "name": "Lefkas Town Quay",
      "city": "Lefkada",
      "country": "Greece",
      "type": "harbour",
      "lat": 38.8329,
      "lon": 20.7102,
      "boat_count": 3,
      "url": "https://charter.boats/locations/4523"
    }
  ]
}

Response Fields

Field	Type	Description
`locations`	array	Matching locations
`locations[].id`	number	Location ID
`locations[].name`	string	Location name
`locations[].city`	string\|null	City
`locations[].country`	string\|null	Country
`locations[].type`	string	Location type: `marina`, `harbour`, `anchorage`, etc.
`locations[].lat`	number	Latitude
`locations[].lon`	number	Longitude
`locations[].boat_count`	integer	Number of published boats at this location
`locations[].url`	string	Link to location page on charter.boats

Errors

Status	Message
`400`	Search query must be at least 2 characters