Search POIs (AI)

Find restaurants, fuel stations, shops, and attractions near a sailing destination

GET/ai/pois

Find points of interest near a sailing destination. Accepts a location name (fuzzy matched), a location ID from a previous search, or a direct POI-name query. Returns POIs sorted by distance from the nearest marina.

Authentication

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

Query Parameters

Parameter	Type	Required	Description
`location`	string	No	Location name (fuzzy matched against name + city). Use this, `location_id`, or `q`.
`location_id`	string	No	Exact location ID from a previous `searchLocations` call.
`q`	string	No	Direct POI-name search (no location required). Returns each POI with `location: null`.
`category`	string	No	Filter by POI category (see below). Omit for all categories.
`limit`	integer	No	Max results (default: 10, max: 30)

At least one of location, location_id, or q is required.

Value	Description
`restaurant`	Restaurants, cafes, bars
`fuel`	Marine and regular fuel stations
`grocery`	Supermarkets, bakeries, convenience stores
`chandlery`	Boat supplies, marine equipment
`pharmacy`	Pharmacies
`bank`	Banks, ATMs, currency exchange
`laundry`	Laundromats
`entertainment`	Attractions, museums, nightlife
`parking`	Parking
`fishing`	Fishing supplies

Request

# Find restaurants near Split (by name)
curl "https://charter.boats/api/ai/pois?location=split&category=restaurant"
 
# Find all POIs near a specific location ID
curl "https://charter.boats/api/ai/pois?location_id=21157&limit=20"
 
# Direct POI name search
curl "https://charter.boats/api/ai/pois?q=Nava"

Response

{
  "pois": [
    {
      "id": "297cb8af-90cd-4acc-ad6a-28325cb105c8",
      "name": "Nautika centar Nava",
      "category": "chandlery",
      "subcategory": "boat_shop",
      "description": "Authorized dealer for Lagoon, Beneteau, X-Yachts, and Nimbus...",
      "rating": null,
      "cuisine": null,
      "phone": null,
      "website": "https://www.navaboats.com/",
      "opening_hours": null,
      "image_url": "https://navaboats.com/wp-content/uploads/2022/12/yacht-sales-croatia-1920x1080.jpg",
      "location": "100 meters from Split, West Coast (Zapadna obala)",
      "url": "https://charter.boats/pois/297cb8af-90cd-4acc-ad6a-28325cb105c8"
    }
  ],
  "locations_searched": ["Split, West Coast (Zapadna obala)"],
  "categories_available": ["parking", "chandlery", "restaurant"]
}

When using q (direct name search), each POI has location: null and the response omits locations_searched.

Response Fields

Field	Type	Description
`pois`	array	Points of interest sorted by distance
`pois[].id`	string	POI UUID
`pois[].name`	string	POI name
`pois[].category`	string	POI category
`pois[].subcategory`	string\|null	More specific category
`pois[].description`	string\|null	Description
`pois[].rating`	number\|null	Rating (1-5)
`pois[].cuisine`	string\|null	Cuisine type (restaurants only)
`pois[].phone`	string\|null	Phone number
`pois[].website`	string\|null	Website URL
`pois[].opening_hours`	string\|null	Opening hours
`pois[].image_url`	string\|null	Image URL
`pois[].location`	string\|null	Distance + nearest marina (e.g. "100 meters from Split, West Coast"). `null` for direct `q` searches.
`pois[].url`	string	Link to the POI page on charter.boats
`locations_searched`	array	Names of the marinas searched (omitted for `q` searches)
`categories_available`	array	Categories that have results, sorted by count

Errors

Status	Message
`400`	Provide location, location_id, or q (search by name)

POI Details

GET/ai/pois/{id}

Full detail for a single point of interest, including address, nearby marinas with walking times, and any special offers. The {id} must be a POI UUID.

Request

curl "https://charter.boats/api/ai/pois/297cb8af-90cd-4acc-ad6a-28325cb105c8"

Response

{
  "id": "297cb8af-90cd-4acc-ad6a-28325cb105c8",
  "name": "Nautika centar Nava",
  "category": "chandlery",
  "subcategory": "boat_shop",
  "description": "Authorized dealer for Lagoon, Beneteau, X-Yachts, and Nimbus...",
  "cuisine": null,
  "address": null,
  "city": null,
  "country": null,
  "phone": null,
  "website": "https://www.navaboats.com/",
  "opening_hours": null,
  "rating": null,
  "rating_count": null,
  "nearby_locations": [
    { "name": "Split, West Coast (Zapadna obala)", "distance_meters": 100, "walking_time_minutes": 2 },
    { "name": "ACI Marina Split", "distance_meters": 230, "walking_time_minutes": 3 }
  ],
  "special_offers": [],
  "url": "https://charter.boats/pois/297cb8af-90cd-4acc-ad6a-28325cb105c8"
}

Response Fields

Field	Type	Description
`id`	string	POI UUID
`name`	string	POI name
`category`	string	POI category
`subcategory`	string\|null	More specific category
`description`	string\|null	Description (trimmed to ~500 chars)
`cuisine`	string\|null	Cuisine type (restaurants only)
`address`	string\|null	Street address
`city`	string\|null	City
`country`	string\|null	Country
`phone`	string\|null	Phone number
`website`	string\|null	Website URL
`opening_hours`	string\|null	Opening hours
`rating`	number\|null	Rating (1-5)
`rating_count`	integer\|null	Number of ratings
`nearby_locations`	array	Up to 3 nearby marinas with `name`, `distance_meters`, `walking_time_minutes`
`special_offers`	array	Up to 3 offers with `title`, `description`, `discount_type`, `discount_value`
`url`	string	Link to the POI page on charter.boats

Errors

Status	Message
`400`	Valid POI UUID required
`404`	POI not found

Search POIs (AI)

On this page