Pull live holiday-rental data from Young Estates.

X-API-Key: your-api-key-from-the-agent-dashboard

<?php
$url = 'https://www.youngestates.com/wp-json/ye/v1/properties?city=St.+James&type=Villa&per_page=20';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: YOUR_API_KEY'],
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
foreach ($result['data'] as $property) {
    echo $property['name'] . ' — ' . $property['bedrooms'] . ' bedrooms\n';
}

{
  "data": [
    {
      "id": 58517,
      "name": "Bluff House",
      "slug": "bluff-house-stay",
      "url": "https://www.youngestates.com/properties/bluff-house-stay/",
      "house_type": "Villa",
      "bedrooms": 8,
      "bathrooms": 8,
      "sleeps": 12,
      "pools": 1,
      "location": {
        "city": "St. James",
        "area": "Sandy Lane Estate",
        "latitude": 13.175458,
        "longitude": -59.636726
      },
      "thumbnail": "https://www.youngestates.com/wp-content/uploads/2024/05/DSC02355-768x512.jpg",
      "updated_at": "2026-05-27T12:14:18+00:00"
    }
  ],
  "meta": {
    "total": 91,
    "page": 1,
    "per_page": 20,
    "total_pages": 5
  }
}

<?php
$id = 58517;
$ch = curl_init("https://www.youngestates.com/wp-json/ye/v1/properties/{$id}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: YOUR_API_KEY'],
]);
$property = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $property['name'];                 // Bluff House
echo $property['bedrooms'];             // 8
$rate = $property['pricing']['rates'][0]['periods'][0]['rate_per_night'];

{
  "id": 58517,
  "name": "Bluff House",
  "slug": "bluff-house-stay",
  "url": "https://www.youngestates.com/properties/bluff-house-stay/",
  "house_type": "Villa",
  "bedrooms": 8,
  "bathrooms": 8,
  "sleeps": 12,
  "pools": 1,
  "location": {
    "city": "St. James",
    "area": "Sandy Lane Estate",
    "latitude": 13.175458,
    "longitude": -59.636726,
    "address": "Sandy Lane Estate, St. James, Barbados"
  },
  "updated_at": "2026-05-27T12:14:18+00:00",
  "square_footage": null,
  "description": "<p>Bluff House is an exceptional beachfront villa...</p>",
  "amenities": ["Media Room", "Children Welcome", "Air Conditioned Bedrooms"],
  "house_rules": ["Children - All Welcome", "No Pets"],
  "taxonomies": {
    "area": ["Sandy Lane Estate"],
    "city": ["St. James"],
    "internal_amenities": ["Wi-Fi", "Media Room"],
    "external_amenities": ["Private Pool", "Direct Beach Access"],
    "bedroom_amenities": [],
    "bathroom_amenities": [],
    "house_rules": [],
    "fire_safety": [],
    "staff": ["Chef", "Housekeeper", "Butler"]
  },
  "rooms": null,
  "pool_size": null,
  "total_guests": 12,
  "security_deposit": 5000,
  "bookable": false,
  "check_in_out_time": "<p>Check-in 15:00 / Check-out 10:00</p>",
  "additional_information": "",
  "additional_house_rules": "",
  "concierge": "",
  "owner_review": "",
  "video": "<iframe ...></iframe>",
  "instagram": "",
  "pricing": {
    "currency": "USD",
    "sale_price": null,
    "long_term_monthly": null,
    "rates": [
      {
        "bedrooms": 8,
        "sleeps": 12,
        "periods": [
          {
            "from": "15 Apr 2026",
            "to": "14 Dec 2026",
            "minimum_stay": 5,
            "price_on_application": false,
            "rate_per_night": 3630
          }
        ]
      }
    ]
  },
  "special_offer": null,
  "stand_out_features": ["Beachfront", "Walk to Sandy Lane"],
  "rooms_detail": [
    {
      "name": "Master bedroom",
      "beds": "King Bed (US)",
      "view": "Sea view",
      "en_suite": true,
      "image": "https://www.youngestates.com/wp-content/uploads/2021/07/Bluff-House-022.jpg",
      "bedroom_amenities": ["Air Conditioning", "Ceiling Fan"],
      "bathroom_amenities": ["Walk-in Shower"]
    }
  ],
  "reviews": [
    { "name": "The Smith Family", "review": "<p>A wonderful stay.</p>" }
  ],
  "staff": {
    "summary": "<p>Fully staffed villa.</p>",
    "roles": [
      { "role": "Cook", "detail": "6 days per week", "season": "Winter & Festive", "meals_per_day": "2 consecutive Meals" }
    ]
  },
  "property_manager": {
    "name": "Maureen Philips",
    "bio": "<p>I have been with Young Estates since 2017...</p>",
    "image": "https://www.youngestates.com/wp-content/uploads/2026/05/DSC09170-768x947.jpg"
  },
  "availability_feeds": ["https://www.youngowners.com/wp-content/uploads/ics/Bluff-House/bookings.ics"],
  "info_sections": [
    { "title": "CONCIERGE SERVICES", "text": "<p>...</p>", "buttons": [ { "text": "MORE", "link": "https://www.youngestates.com/concierge/" } ] }
  ],
  "related": [
    { "id": 58463, "name": "Sea Breeze", "url": "https://www.youngestates.com/properties/sea-breeze/" }
  ],
  "images": [
    "https://www.youngestates.com/wp-content/uploads/2024/05/DSC02355-1024x683.jpg",
    "https://www.youngestates.com/wp-content/uploads/2024/05/DSC02360-1024x683.jpg"
  ]
}

<?php
$ch = curl_init('https://www.youngestates.com/wp-json/ye/v1/properties/58517/images');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: YOUR_API_KEY'],
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

foreach ($result['images'] as $src) {
    echo '<img src="' . htmlspecialchars($src) . '">';
}

// GET /properties/58517/bedrooms
{ "bedrooms": 8 }

// GET /properties/58517/rooms_detail
{ "rooms_detail": [ { "name": "Master bedroom", ... } ] }

<?php
$response = wp_remote_get(
    'https://www.youngestates.com/wp-json/ye/v1/properties?city=St.+James',
    [ 'headers' => [ 'X-API-Key' => getenv('YE_API_KEY') ] ]
);

if ( is_wp_error( $response ) ) {
    error_log( 'YE API error: ' . $response->get_error_message() );
    return;
}

$body = json_decode( wp_remote_retrieve_body( $response ), true );
foreach ( $body['data'] as $property ) {
    echo esc_html( $property['name'] );
}

{
  "code": "ye_invalid_key",
  "message": "Missing or invalid API key.",
  "data": { "status": 401 }
}

{
  "code": "ye_property_withdrawn",
  "message": "Property #58481 (Magnolia) is no longer available through the Young Estates API. Please remove it from your system.",
  "data": { "status": 410, "property_id": 58481, "action": "remove" }
}