Search Locations (AI)

GET/ai/locations

Search for sailing locations — marinas, harbours, and anchorages where a boat can berth or drop anchor and stay overnight (charter bases are locations too). 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=split&limit=3"

Response

{
  "locations": [
    {
      "id": 21166,
      "name": "Split, MCI Marine Club International",
      "city": "Split",
      "country": "Croatia",
      "type": "marina",
      "lat": 43.527441,
      "lon": 16.461807,
      "boat_count": 7,
      "url": "https://charter.boats/locations/21166"
    },
    {
      "id": 21157,
      "name": "Split, West Coast (Zapadna obala)",
      "city": "Split",
      "country": "Croatia",
      "type": "marina",
      "lat": 43.504576,
      "lon": 16.430397,
      "boat_count": 39,
      "url": "https://charter.boats/locations/21157"
    }
  ]
}

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 (`harbour_category`, defaults to `marina`)
`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

Location Details

GET/ai/locations/{id}

Full detail for a single location: description, coordinates, facilities, rating, and a summary of nearby points of interest.

Request

curl "https://charter.boats/api/ai/locations/21157"

Response

{
  "id": 21157,
  "name": "Split, West Coast (Zapadna obala)",
  "city": "Split",
  "municipality": "Grad Split",
  "country": "Croatia",
  "type": "marina",
  "description": "Split's West Coast Marina (Zapadna Obala) puts you right in the heart of the city, with Diocletian's Palace and the buzzing Riva promenade just steps from your berth...",
  "lat": 43.504576,
  "lon": 16.430397,
  "capacity": null,
  "max_draft": null,
  "vhf_channel": null,
  "phone": null,
  "website": null,
  "rating": 3.8,
  "rating_count": 19,
  "boat_count": 0,
  "amenities": [],
  "poi_categories": [
    "parking", "chandlery", "restaurant", "fuel", "grocery",
    "bank", "pharmacy", "fishing", "entertainment", "laundry"
  ],
  "poi_count": 200,
  "url": "https://charter.boats/locations/21157"
}

Response Fields

Field	Type	Description
`id`	number	Location ID
`name`	string	Location name
`city`	string\|null	City
`municipality`	string\|null	Municipality
`country`	string\|null	Country
`type`	string	Location type (`harbour_category`, defaults to `marina`)
`description`	string\|null	Description (trimmed to ~500 chars)
`lat`	number	Latitude
`lon`	number	Longitude
`capacity`	number\|null	Berth capacity
`max_draft`	number\|null	Maximum draft in metres
`vhf_channel`	string\|null	Marina VHF channel
`phone`	string\|null	Contact phone
`website`	string\|null	Website URL
`rating`	number\|null	Average rating
`rating_count`	integer\|null	Number of ratings
`boat_count`	integer	Boats listed directly at this location
`amenities`	array	List of amenity names
`poi_categories`	array	POI categories present near this location
`poi_count`	integer	Total nearby points of interest
`url`	string	Link to location page on charter.boats

Errors

Status	Message
`400`	Location ID required
`404`	Location not found

Search Locations (AI)

On this page