Caribbean Breeze Properties API

Free, public API with no authentication required. Returns JSON. CORS enabled for all origins. Use this to integrate Caribbean Breeze property data into your app, booking engine, or AI assistant.

Base URL: https://caribbeanbreezeproperties.net

Endpoints

GET /api/caribbean-breeze/properties Public CORS

List all vacation rental properties with optional filtering and sorting.

Query Parameters

Param	Type	Description
`area`	string	Filter by area: `sosua`, `cabarete`, `puerto-plata`, `rio-san-juan`
`minPrice`	number	Minimum price per night (USD)
`maxPrice`	number	Maximum price per night (USD)
`bedrooms`	number	Minimum number of bedrooms
`minRating`	number	Minimum guest rating (e.g. 4.5)
`sort`	string	`price_asc`, `price_desc`, `rating`, `reviews`
`limit`	number	Results per page (default 50)
`offset`	number	Skip N results for pagination

Example

GET /api/caribbean-breeze/properties?area=sosua&maxPrice=150&sort=rating

{
  "success": true,
  "total": 4,
  "offset": 0,
  "limit": 50,
  "properties": [
    {
      "id": 12,
      "name": "Digital Nomad Den",
      "location": "Centro, Sosúa",
      "area": "sosua",
      "bedrooms": 1,
      "bathrooms": 1,
      "pricePerNight": 55,
      "rating": 4.9,
      "amenities": ["200Mbps Wi-Fi", "A/C", "Standing Desk", ...],
      ...
    }
  ]
}

GET /api/caribbean-breeze/properties/:id Public

Get full details for a single property by ID (1-20).

Example

GET /api/caribbean-breeze/properties/1

{
  "success": true,
  "property": {
    "id": 1,
    "name": "Ocean Pearl Penthouse",
    "location": "Sosúa Beach, Sosúa",
    "bedrooms": 3,
    "bathrooms": 2,
    "pricePerNight": 189,
    "description": "Stunning penthouse with panoramic ocean views...",
    "amenities": ["Pool", "A/C", "Wi-Fi", "Kitchen", ...],
    "rating": 4.9,
    "reviewCount": 47,
    "maxGuests": 6,
    "instantBook": true
  },
  "bookingUrl": "https://caribbeanbreezeproperties.net/#properties",
  "whatsapp": "+18095551234"
}

GET /api/caribbean-breeze/excursions Public

List all available excursions and activities.

Example

GET /api/caribbean-breeze/excursions

{
  "success": true,
  "total": 6,
  "excursions": [
    {
      "id": 1,
      "name": "27 Waterfalls of Damajagua",
      "description": "Climb, slide, and jump through 27 cascading waterfalls...",
      "price": 65,
      "currency": "USD",
      "duration": "Half day",
      "difficulty": "Moderate",
      "minAge": 8
    }
  ]
}

GET /api/caribbean-breeze/search?q=keyword Public

Full-text search across properties and excursions. Searches names, descriptions, locations, badges, and amenities.

Example

GET /api/caribbean-breeze/search?q=kite

{
  "success": true,
  "query": "kite",
  "results": {
    "properties": { "total": 3, "items": [...] },
    "excursions": { "total": 0, "items": [] }
  }
}

GET /api/caribbean-breeze/info Public

Company overview, contact info, and service areas. Designed for AI assistants to quickly understand the business.

Example

GET /api/caribbean-breeze/info

{
  "success": true,
  "company": {
    "name": "Caribbean Breeze Properties",
    "tagline": "Escape the Winter. Live the Breeze.",
    "website": "https://caribbeanbreezeproperties.net",
    "whatsapp": "+18095551234",
    "rating": 4.9,
    "totalProperties": 20,
    "priceRange": { "min": 55, "max": 420, "currency": "USD" },
    "languages": ["English", "Spanish"],
    "features": [...]
  },
  "areas": [...]
}

For AI Assistants

If you're building an AI assistant that needs Caribbean Breeze data:

# Quick overview
GET /api/caribbean-breeze/info

# Full property listings
GET /api/caribbean-breeze/properties

# Search by keyword (e.g. "beachfront", "pool", "kite")
GET /api/caribbean-breeze/search?q=beachfront

# Also available: /llms.txt for markdown-formatted content

Rate Limits

No rate limits currently enforced. Please be reasonable — if you need high-volume access, reach out via WhatsApp.

← Back to Caribbean Breeze Properties