Search Experiences

Endpoint

GET /experiences/search

Description

Search for local experience providers (dive shops, restaurants, tours, etc.) near a geographic location. Returns provider locations within a specified radius, sorted by distance.

Authentication

No authentication required. This is a public endpoint.

Query Parameters

Parameter	Type	Required	Description
`lat`	number	Yes	Latitude of search center
`lng`	number	Yes	Longitude of search center
`radius`	number	No	Search radius in km (default: 50)
`business_type`	string	No	Filter by provider business type
`category`	string	No	Filter offerings by category
`limit`	number	No	Max results (default: 20)

Business Types

Value	Description
`dive_shop`	Scuba diving, snorkeling
`restaurant`	Waterfront dining
`tour_operator`	Guided tours, excursions
`equipment_rental`	Kayaks, paddleboards, gear
`marina_services`	Docking, fuel, repairs
`provisioning`	Groceries, supplies delivery
`water_sports`	Jet skis, parasailing
`fishing_charter`	Guided fishing trips
`sailing_school`	Lessons, certifications
`yacht_club`	Membership, events
`other`	Other marine-related business

Example Request

curl "https://charter.boats/api/experiences/search?lat=38.83&lng=20.71&radius=25&business_type=dive_shop"

Example Response

[
  {
    "id": "a1b2c3d4-...",
    "name": "Lefkas Marina Dock",
    "latitude": 38.8340,
    "longitude": 20.7065,
    "distance_km": 1.8,
    "provider": {
      "id": "e5f6a7b8-...",
      "business_name": "Ionian Dive Center",
      "business_type": "dive_shop",
      "logo_url": "https://example.com/logo.png",
      "website": "https://ioniandive.com",
      "phone": "+30 2645 012345",
      "is_verified": true
    },
    "offerings": [
      {
        "id": "c9d0e1f2-...",
        "title": "Reef Snorkeling Tour",
        "category": "tour",
        "price_from": 65,
        "price_to": 65,
        "duration_minutes": 180,
        "is_active": true
      }
    ]
  }
]

Response Fields

Field	Type	Description
`id`	string	Location ID
`name`	string	Location name
`latitude`	number	Location latitude
`longitude`	number	Location longitude
`distance_km`	number	Distance from search center in km
`provider`	object	Provider details
`provider.id`	string	Provider ID
`provider.business_name`	string	Business name
`provider.business_type`	string	Type of business
`provider.logo_url`	string\|null	Logo image URL
`provider.website`	string\|null	Website URL
`provider.phone`	string\|null	Contact phone
`provider.is_verified`	boolean	Verified status
`offerings`	array	Active offerings at this location
`offerings[].id`	string	Offering ID
`offerings[].title`	string	Offering title
`offerings[].category`	string	Offering category
`offerings[].price_from`	number\|null	Starting price
`offerings[].price_to`	number\|null	Maximum price
`offerings[].duration_minutes`	number\|null	Duration in minutes

Notes

Only active providers and their active offerings are returned
Results are sorted by distance (nearest first)
When category is specified, locations with no matching offerings are excluded from results
Distance is calculated using the Haversine formula

Search Experiences

On this page