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) or a location ID from a previous search. 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). Use this OR `location_id`.
`location_id`	string	No	Exact location ID from a previous `searchLocations` call.
`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 or location_id 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
`water`	Water points
`ice`	Ice suppliers
`fishing`	Fishing supplies
`provisioning`	Provisioning services
`other`	Other

Request

# Find restaurants near Lefkada
curl "https://charter.boats/api/ai/pois?location=Lefkada&category=restaurant"
 
# Find all POIs near a specific location ID
curl "https://charter.boats/api/ai/pois?location_id=4521&limit=20"

Response

{
  "pois": [
    {
      "id": "poi-uuid-1",
      "name": "Taverna Nidri",
      "category": "restaurant",
      "subcategory": "taverna",
      "description": "Traditional Greek taverna on the waterfront",
      "rating": 4.7,
      "cuisine": "greek",
      "phone": "+30 2645 099999",
      "website": "https://example.com",
      "opening_hours": "Mo-Su 12:00-23:00",
      "image_url": "https://...",
      "distance_from_marina": "350m"
    }
  ],
  "categories_available": ["restaurant", "grocery", "fuel", "pharmacy"]
}

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
`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 (OSM format)
`pois[].image_url`	string\|null	Image URL
`pois[].distance_from_marina`	string	Distance from nearest marina (e.g. "200m" or "1.5km")
`categories_available`	array	Categories that have results at this location, sorted by count

Errors

Status	Message
`400`	Provide location or location_id