Search Trips (AI)

GET/ai/trips

Search community-created and AI-generated sailing itineraries with day-by-day plans. Useful for trip planning -- includes duration, distance, activities, and ratings.

Authentication

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

Query Parameters

Parameter	Type	Required	Description
`location`	string	No	Destination name (fuzzy matched). Finds trips starting in or passing through this area.
`location_id`	string	No	Exact location ID
`boat_type`	string	No	Filter by boat type used in the itinerary
`min_days`	integer	No	Minimum trip duration in days
`max_days`	integer	No	Maximum trip duration in days
`activities`	string	No	Comma-separated activity filters. Matches trips that include any of these activities. Examples: `swimming,snorkeling`, `nightlife,local_cuisine`
`limit`	integer	No	Max results (default: 5, max: 20)

Request

# Find 7-day itineraries in Greece
curl "https://charter.boats/api/ai/trips?location=Greece&min_days=7&max_days=7"
 
# Sailing trips with snorkeling activities
curl "https://charter.boats/api/ai/trips?location=Lefkada&activities=snorkeling,swimming"

Response

{
  "trips": [
    {
      "id": "trip-uuid-1",
      "title": "Ionian Island Hopping - 7 Days",
      "start_location": "Lefkada",
      "location": "D-Marin Lefkas, Lefkada, Greece",
      "duration_days": 7,
      "distance_nm": 85,
      "boat_type": "sailboat",
      "activities": ["swimming", "snorkeling", "local_cuisine", "hiking"],
      "rating": 4.7,
      "review_count": 8,
      "favorite_count": 42,
      "url": "https://charter.boats/trips/trip-uuid-1"
    }
  ]
}

Response Fields

Field	Type	Description
`trips`	array	Matching itineraries sorted by rating then favorites
`trips[].id`	string	Trip UUID
`trips[].title`	string	Trip title
`trips[].start_location`	string	Starting location name
`trips[].location`	string	Resolved location name (marina, city, country)
`trips[].duration_days`	integer	Trip duration in days
`trips[].distance_nm`	number\|null	Total distance in nautical miles
`trips[].boat_type`	string\|null	Recommended boat type
`trips[].activities`	array	Activities included in the itinerary
`trips[].rating`	number\|null	Average rating
`trips[].review_count`	integer	Number of reviews
`trips[].favorite_count`	integer	Number of users who favorited this trip
`trips[].url`	string	Link to trip page on charter.boats