Hospitality API for
Developers

curl -X GET "https://api.stayapi.com/v1/meta/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G \
  -d "hotel_name=Four Seasons Resort Bali" \
  -d "location=Jimbaran, Indonesia"

curl -X GET "https://api.stayapi.com/v1/booking/hotel/reviews" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G \
  -d "url=le-grand-hotel-paris" \
  -d "per_page=20" \
  -d "page=1"

curl -X GET "https://api.stayapi.com/v1/booking/hotel/details" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G \
  -d "url=le-grand-hotel-paris"

curl -X GET "https://api.stayapi.com/v1/booking/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "Paris, France",
    "checkin": "2024-03-15",
    "checkout": "2024-03-20",
    "adults": 2,
    "rooms": 1
  }'

curl -X GET "https://api.stayapi.com/v1/tripadvisor/extract-location-id" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -G \
  -d "url=https://www.tripadvisor.com/Hotel_Review-g187147-d230166-Reviews-Le_Grand_Hotel_InterContinental-Paris_Ile_de_France.html"

{
  "status": "success",
  "data": {
    "hotel_name": "Four Seasons Resort Bali",
    "location": "Jimbaran, Indonesia",
    "links": {
      "booking_com": "https://www.booking.com/hotel/id/four-seasons-resort-bali-at-jimbaran-bay.html",
      "expedia": "https://www.expedia.com/Jimbaran-Hotels-Four-Seasons-Resort-Bali.h1234567.Hotel-Information",
      "hotels_com": "https://hotels.com/ho123456/four-seasons-resort-bali-jimbaran-indonesia/",
      "agoda": "https://www.agoda.com/four-seasons-resort-bali-at-jimbaran-bay/hotel/bali-id.html",
      "tripadvisor": "https://www.tripadvisor.com/Hotel_Review-g469404-d301386-Reviews-Four_Seasons_Resort_Bali_at_Jimbaran_Bay.html",
      "official_website": "https://www.fourseasons.com/jimbaran/",
      "kayak": "https://www.kayak.com/hotels/Four-Seasons-Resort-Bali-c47329.h123456.Hotel-Information"
    },
    "platform_count": 8,
    "official_website_detected": true
  }
}

{
  "status": "success",
  "data": {
    "hotel_name": "Le Grand Hotel InterContinental",
    "total_reviews": 2847,
    "average_rating": 4.8,
    "reviews": [
      {
        "id": "review_789",
        "author": "Sophie M.",
        "country": "France",
        "rating": 5,
        "title": "Exceptional luxury experience",
        "text": "The service was impeccable and the location is perfect for exploring Paris. The rooms are beautifully decorated and the breakfast was outstanding.",
        "date": "2024-02-15",
        "helpful_votes": 12,
        "photos": [
          "https://images.booking.com/review_123.jpg"
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total_pages": 143,
      "has_next": true
    }
  }
}

{
  "status": "success",
  "data": {
    "hotel_id": "hotel_123",
    "name": "Le Grand Hotel InterContinental",
    "description": "A legendary luxury hotel in the heart of Paris, offering elegant accommodations and world-class service since 1862.",
    "address": "2 Rue Scribe, 75009 Paris, France",
    "coordinates": {
      "latitude": 48.871586,
      "longitude": 2.330359
    },
    "star_rating": 5,
    "review_rating": 4.8,
    "total_reviews": 2847,
    "photos": [
      "https://images.booking.com/hotel_123_main.jpg",
      "https://images.booking.com/hotel_123_lobby.jpg",
      "https://images.booking.com/hotel_123_room.jpg"
    ],
    "contact": {
      "phone": "+33 1 40 07 32 32",
      "email": "reservations.paris@ihg.com",
      "website": "https://www.ihg.com/intercontinental/hotels/paris"
    },
    "check_in": "15:00",
    "check_out": "12:00"
  }
}

{
  "status": "success",
  "data": {
    "destination": "Paris, France",
    "checkin": "2024-03-15",
    "checkout": "2024-03-20",
    "hotels": [
      {
        "id": "hotel_123",
        "name": "Le Grand Hotel InterContinental",
        "location": "2 Rue Scribe, 75009 Paris",
        "rating": 4.8,
        "review_score": 9.2,
        "price": {
          "amount": 450,
          "currency": "EUR",
          "per": "night"
        },
        "star_rating": 5,
        "amenities": ["WiFi", "Spa", "Restaurant"],
        "availability": true
      },
      {
        "id": "hotel_456",
        "name": "Hotel Plaza Athénée",
        "location": "25 Avenue Montaigne, 75008 Paris",
        "rating": 4.9,
        "price": {
          "amount": 850,
          "currency": "EUR",
          "per": "night"
        },
        "star_rating": 5,
        "availability": true
      }
    ],
    "total": 142,
    "page": 1
  }
}

{
  "status": "success",
  "data": {
    "location_id": "230166",
    "extracted_from_url": "https://www.tripadvisor.com/Hotel_Review-g187147-d230166-Reviews-Le_Grand_Hotel_InterContinental-Paris_Ile_de_France.html",
    "hotel_name": "Le Grand Hotel InterContinental",
    "city": "Paris",
    "region": "Ile de France",
    "country": "France",
    "coordinates": {
      "latitude": 48.871586,
      "longitude": 2.330359
    },
    "timezone": "Europe/Paris",
    "useful_for": [
      "Getting TripAdvisor reviews",
      "Location-based searches",
      "Cross-platform hotel matching"
    ],
    "sample_reviews_endpoint": "https://api.stayapi.com/v1/tripadvisor/reviews/230166",
    "estimated_reviews": 1245
  }
}