Properties API Documentation

$API = 'https://listings.4u-realestate.org';
$KEY = 'YOUR_API_KEY';

// === LIST ===
$ch = curl_init("$API/properties?limit=10");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: $KEY", "Accept: application/json"]
]);
$list = json_decode(curl_exec($ch), true);
curl_close($ch);

// === CREATE ===
$ch = curl_init("$API/properties");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["x-api-key: $KEY", "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'New Beach Villa',
    'status' => 'draft',
    'price' => 500,
    'priceUnit' => 'per_night',
    'bedrooms' => 3,
    'city' => 'Simpson Bay',
    'propertyType' => ['villas'],
    'purposes' => ['vacation-rentals'],
    'features' => ['Pool', 'WiFi'],
    'featuredImage' => ['url' => 'https://example.com/villa.jpg', 'alt' => 'Villa', 'order' => 0]
  ])
]);
$created = json_decode(curl_exec($ch), true);
curl_close($ch);
$id = $created['property']['_id'];

// === UPDATE ===
$ch = curl_init("$API/properties/$id");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_HTTPHEADER => ["x-api-key: $KEY", "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(['status' => 'published', 'price' => 550])
]);
curl_exec($ch);
curl_close($ch);

// === DELETE ===
$ch = curl_init("$API/properties/$id");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'DELETE',
  CURLOPT_HTTPHEADER => ["x-api-key: $KEY"]
]);
curl_exec($ch);
curl_close($ch);

import requests

API = 'https://listings.4u-realestate.org'
HEADERS = {'x-api-key': 'YOUR_API_KEY', 'Content-Type': 'application/json'}

# === LIST ===
r = requests.get(f'{API}/properties', params={'limit': 10}, headers=HEADERS)
data = r.json()
print(f"Total: {data['total']}")

# === CREATE ===
r = requests.post(f'{API}/properties', headers=HEADERS, json={
    'title': 'New Beach Villa',
    'status': 'draft',
    'price': 500,
    'priceUnit': 'per_night',
    'bedrooms': 3,
    'city': 'Simpson Bay',
    'propertyType': ['villas'],
    'purposes': ['vacation-rentals'],
    'features': ['Pool', 'WiFi'],
    'featuredImage': {'url': 'https://example.com/villa.jpg', 'alt': 'Villa', 'order': 0},
    'gallery': [
        {'url': 'https://example.com/pool.jpg', 'alt': 'Pool', 'order': 1}
    ]
})
prop_id = r.json()['property']['_id']

# === UPDATE ===
requests.put(f'{API}/properties/{prop_id}', headers=HEADERS, json={
    'status': 'published', 'price': 550
})

# === DELETE ===
requests.delete(f'{API}/properties/{prop_id}', headers=HEADERS)

# List properties
curl -s -H "x-api-key: YOUR_KEY" \
  "https://listings.4u-realestate.org/properties?limit=10" | jq .

# Create property
curl -s -X POST "https://listings.4u-realestate.org/properties" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"New Villa","price":500,"bedrooms":3,"status":"draft"}' | jq .

# Update property
curl -s -X PUT "https://listings.4u-realestate.org/properties/PROPERTY_ID" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"published","price":550}' | jq .

# Delete property
curl -s -X DELETE "https://listings.4u-realestate.org/properties/PROPERTY_ID" \
  -H "x-api-key: YOUR_KEY" | jq .