Hotels API Documentation

curl -H "X-API-KEY: your_api_key_here" \
  "https://api.hotels-api.com/v1/hotels/search?city=Madrid"

{
  "success": true,
  "data": [...],
  "message": null,
  "timestamp": 1768924228
}

{
  "success": false,
  "error": "City parameter is required"
}

curl -X GET "https://api.hotels-api.com/v1/hotels/search?city=Madrid&limit=5" \\\n  -H "X-API-KEY: your_api_key_here"

{
  "success": true,
  "data": [
    {
      "id": 698731,
      "name": "NH Collection Madrid Abascal",
      "city": "Madrid",
      "country": "Spain",
      "country_code": "ES",
      "address": "José Abascal 47 28003 Madrid",
      "rating": 4,
      "lat": 40.438236,
      "lng": -3.695222,
      "amenities": ["bar", "free_wifi", "front_desk_24h", "gym", "parking", "spa"]
    },
    {
      "id": 698733,
      "name": "Hyatt Regency Hesperia Madrid",
      "city": "Madrid",
      "country": "Spain",
      "country_code": "ES",
      "address": "Paseo Castellana 57 28046 Madrid",
      "rating": 5,
      "lat": 40.438854,
      "lng": -3.69141,
      "amenities": ["airport_shuttle", "bar", "free_wifi", "gym", "restaurant", "spa"]
    }
  ],
  "message": null,
  "timestamp": 1768924228
}

curl -X GET "https://api.hotels-api.com/v1/hotels/nearby?lat=40.4168&lng=-3.7038&radius=5&limit=10" \
  -H "X-API-KEY: your_api_key_here"

{
  "success": true,
  "data": [
    {
      "id": 698752,
      "name": "Insignia Hotel Dosa",
      "city": "Madrid",
      "country": "Spain",
      "country_code": "ES",
      "address": "C/ De las Heras 96-98 28723 Pedrezuela Madrid",
      "rating": 3,
      "lat": 40.4167754,
      "lng": -3.7037902,
      "amenities": ["parking", "wheelchair_access", "pets_allowed"]
    },
    {
      "id": 698818,
      "name": "Hostal Victoria I",
      "city": "Madrid",
      "country": "Spain",
      "country_code": "ES",
      "address": "Carretas 7 2º 2 Floor 28012 Madrid",
      "rating": 0,
      "lat": 40.41635,
      "lng": -3.70319,
      "amenities": ["air_conditioning", "free_wifi", "front_desk_24h"]
    }
  ],
  "message": null,
  "timestamp": 1768924239
}

const axios = require('axios');

class HotelsAPI {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = 'https://api.hotels-api.com/v1';
  }

  async searchByCity(city, options = {}) {
    try {
      const response = await axios.get(`${this.baseURL}/hotels/search`, {
        headers: {
          'X-API-KEY': this.apiKey
        },
        params: {
          city,
          limit: options.limit || 20,
          page: options.page || 1
        }
      });
      return response.data;
    } catch (error) {
      console.error('Error:', error.response?.data || error.message);
      throw error;
    }
  }

  async findNearby(lat, lng, radius = 10) {
    try {
      const response = await axios.get(`${this.baseURL}/hotels/nearby`, {
        headers: {
          'X-API-KEY': this.apiKey
        },
        params: { lat, lng, radius }
      });
      return response.data;
    } catch (error) {
      console.error('Error:', error.response?.data || error.message);
      throw error;
    }
  }
}

// Usage
const api = new HotelsAPI('your_api_key_here');

// Search hotels in Madrid
api.searchByCity('Madrid', { limit: 10 })
  .then(data => {
    console.log(`Found ${data.data.length} hotels`);
    data.data.forEach(hotel => {
      console.log(`- ${hotel.name} (${hotel.rating}⭐)`);
    });
  });

// Find nearby hotels
api.findNearby(40.4168, -3.7038, 5)
  .then(data => {
    console.log(`Found ${data.data.length} hotels within 5km`);
  });

import requests
from typing import Optional, Dict, List

class HotelsAPI:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = 'https://api.hotels-api.com/v1'
        self.headers = {'X-API-KEY': api_key}
    
    def search_by_city(self, city: str, limit: int = 20, page: int = 1) -> Dict:
        """Search hotels by city name"""
        params = {
            'city': city,
            'limit': limit,
            'page': page
        }
        
        response = requests.get(
            f'{self.base_url}/hotels/search',
            headers=self.headers,
            params=params
        )
        response.raise_for_status()
        return response.json()
    
    def find_nearby(self, lat: float, lng: float, radius: int = 10, limit: int = 20) -> Dict:
        """Find hotels near GPS coordinates"""
        params = {
            'lat': lat,
            'lng': lng,
            'radius': radius,
            'limit': limit
        }
        
        response = requests.get(
            f'{self.base_url}/hotels/nearby',
            headers=self.headers,
            params=params
        )
        response.raise_for_status()
        return response.json()

# Usage example
if __name__ == '__main__':
    api = HotelsAPI('your_api_key_here')
    
    # Search hotels in Madrid
    result = api.search_by_city('Madrid', limit=10)
    if result['success']:
        print(f"Found {len(result['data'])} hotels")
        for hotel in result['data']:
            print(f"- {hotel['name']} ({hotel['rating']}⭐)")
    
    # Find nearby hotels
    nearby = api.find_nearby(40.4168, -3.7038, radius=5)
    if nearby['success']:
        print(f"\nFound {len(nearby['data'])} hotels within 5km")

<?php

class HotelsAPI {
    private $apiKey;
    private $baseURL;
    
    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
        $this->baseURL = 'https://api.hotels-api.com/v1';
    }
    
    private function makeRequest($endpoint, $params = []) {
        $url = $this->baseURL . $endpoint;
        
        if (!empty($params)) {
            $url .= '?' . http_build_query($params);
        }
        
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'X-API-KEY: ' . $this->apiKey
        ]);
        
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);
        
        if ($httpCode !== 200) {
            throw new Exception("API request failed with code $httpCode");
        }
        
        return json_decode($response, true);
    }
    
    public function searchByCity($city, $limit = 20, $page = 1) {
        return $this->makeRequest('/hotels/search', [
            'city' => $city,
            'limit' => $limit,
            'page' => $page
        ]);
    }
    
    public function findNearby($lat, $lng, $radius = 10, $limit = 20) {
        return $this->makeRequest('/hotels/nearby', [
            'lat' => $lat,
            'lng' => $lng,
            'radius' => $radius,
            'limit' => $limit
        ]);
    }
}

// Usage example
$api = new HotelsAPI('your_api_key_here');

// Search hotels
$result = $api->searchByCity('Madrid', 10);
if ($result['success']) {
    echo "Found " . count($result['data']) . " hotels\n";
    foreach ($result['data'] as $hotel) {
        echo "- {$hotel['name']} ({$hotel['rating']}⭐)\n";
    }
}

// Find nearby
$nearby = $api->findNearby(40.4168, -3.7038, 5);
if ($nearby['success']) {
    echo "\nFound " . count($nearby['data']) . " hotels within 5km\n";
}

?>