API Reference

Samui Services API Documentation

Integrate with the premier business and service directory of Koh Samui. Our API provides structured endpoints for querying islands, categories, and business listings.

Getting Started

BASE URL

https://samuiservices.com/api

AUTHENTICATION

Public endpoints do not require authentication. Agent-based interactions require Bearer authentication. Refer to auth.md for details.

Endpoints

GET/businesses

Retrieve a list of businesses, optionally filtered by island or category.

Parameters

  • island (optional) - Filter by island slug (e.g. koh-samui)
  • category (optional) - Filter by category slug (e.g. construction)
GET/businesses/{id}

Retrieve detailed information for a specific business by ID.

GET/search

Query listings based on search terms. Returns up to 5 best matched results.

Parameters

  • q (required) - Search term (minimum 3 characters)
  • island (optional) - Filter by island slug