Booking.com Property API Documentation

Property

Name

url

Required

Required

Description

The Booking.com property page URL (e.g. https://www.booking.com/hotel/hr/city-residences.html). Obtain it from the properties[].link field of a Booking.com API response.

Date Range

Name

check_in_date

Required

Optional

Description

The check-in date in YYYY-MM-DD format. Determines the room rates and availability shown for the stay. It is rejected with a 400 unless it is sent together with check_out_date, is a real calendar date, and is not already past in Etc/GMT+12 — the last time zone on earth to roll a date over. Booking prices a stay rather than a date, so the rooms array is returned only when both dates are supplied, and is omitted when the property has no availability for the requested stay.
Name

check_out_date

Required

Optional

Description

The check-out date in YYYY-MM-DD format. It is rejected with a 400 unless it is sent together with check_in_date, is a real calendar date that is not already past in Etc/GMT+12, falls strictly later than check_in_date, and leaves a stay of no more than 90 nights.

Guests

Name

adults

Required

Optional

Description

The number of adult guests. An integer between 1 and 30.
Name

children_ages

Required

Optional

Description

A comma-separated list of the children's ages, each between 0 and 17 (e.g. 5,8). The number of values sets the number of children; an age outside that range is a 400.
Name

rooms

Required

Optional

Description

The number of rooms to search for. An integer between 1 and 30.

Localization

Name

currency

Required

Optional

Description

The ISO currency code the room prices are returned in (e.g. EUR, GBP). Check the full list of supported Booking.com currency values. When omitted, Booking prices the page in its own default for the request, which is not guaranteed to be stable between calls.
Name

language

Required

Optional

Description

The language of the returned property content (e.g. de, fr): room names, amenities, house rules and review categories. Booking encodes it in the property URL path, so the value you send is the language you get back. Check the full list of supported Booking.com language values. Defaults to en-us — Booking's own default English — rather than being left to Booking, so the same request returns the same language every time.

Engine

Name

engine

Required

Required

Description

Parameter defines an engine that will be used to retrieve real-time data. It must be set to booking_property.

API key

Name

api_key

Required

Required

Description

The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

Name

zero_retention

Enterprise Only

Enterprise Only

Required

Optional

Description

Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

A full property response: property_information, rooms, amenities, review_topics, review_summary, featured_reviews, nearby_places, nearby_beaches and house_rules. Blocks Booking has no data for are omitted rather than returned empty, so a property with guest questions also carries faqs.

GET

https://www.searchapi.io/api/v1/search?adults=2&check_in_date=2026-10-02&check_out_date=2026-10-09&engine=booking_property&url=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fhr%2Fsumratin-dubrovnik.html

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "booking_property",
  "url": "https://www.booking.com/hotel/hr/sumratin-dubrovnik.html",
  "check_in_date": "2026-10-02",
  "check_out_date": "2026-10-09",
  "adults": 2
}

response = requests.get(url, params=params)
print(response.text)

Response

{
  "search_metadata": {
    "id": "search_ZxRvzEGkNolVqFxpj4Q9WJbO",
    "status": "Success",
    "created_at": "2026-08-27T07:22:48Z",
    "request_time_taken": 5.23,
    "parsing_time_taken": 0.1,
    "total_time_taken": 5.33,
    "request_url": "https://www.booking.com/hotel/hr/sumratin-dubrovnik.html?checkin=2026-09-24&checkout=2026-10-01&group_adults=2&no_rooms=1&lang=en-us",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_ZxRvzEGkNolVqFxpj4Q9WJbO.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_ZxRvzEGkNolVqFxpj4Q9WJbO"
  },
  "search_parameters": {
    "engine": "booking_property",
    "url": "https://www.booking.com/hotel/hr/sumratin-dubrovnik.html",
    "check_in_date": "2026-09-24",
    "check_out_date": "2026-10-01",
    "adults": 2,
    "rooms": 1,
    "language": "en-us"
  },
  "property_information": {
    "name": "Hotel Sumratin",
    "property_id": "13513449",
    "city_id": "-79996",
    "page_name": "sumratin-dubrovnik",
    "description": "Located in Dubrovnik, a 3-minute walk from Lapad Bay Beach, Hotel Sumratin has accommodations with a garden, private parking, a restaurant and a bar.",
    "property_type": "HOTEL",
    "address": "Ulica Mata Vodopića 1a, Lapad, 20000 Dubrovnik, Croatia",
    "street": "Ulica Mata Vodopića 1a",
    "city": "Dubrovnik",
    "region": "Dubrovnik-Neretva County",
    "postal_code": "20000",
    "country_code": "hr",
    "country": "Croatia",
    "rating": 9.4,
    "max_rating": 10,
    "reviews": 474,
    "rating_word": "Wonderful",
    "review_breakdown": {
      "staff": {
        "score": 9.4,
        "label": "Staff",
        "city_average_low": 8.9,
        "city_average_high": 10.0
      },
      "services": {
        "score": 9.6,
        "label": "Facilities",
        "city_average_low": 8.4,
        "city_average_high": 9.8
      },
      "clean": {
        "score": 9.8,
        "label": "Cleanliness",
        "city_average_low": 8.7,
        "city_average_high": 10.0
      },
      "comfort": {
        "score": 9.8,
        "label": "Comfort",
        "city_average_low": 8.6,
        "city_average_high": 9.9
      },
      "value": {
        "score": 9.1,
        "label": "Value for money",
        "city_average_low": 8.3,
        "city_average_high": 9.6
      },
      "location": {
        "score": 9.5,
        "label": "Location",
        "city_average_low": 8.6,
        "city_average_high": 9.8
      },
      "free_wifi": {
        "score": 9.8,
        "label": "Free Wifi",
        "city_average_low": 8.3,
        "city_average_high": 9.8
      }
    },
    "hotel_class": 5,
    "is_preferred": true,
    "currency": "USD",
    "base_currency": "EUR",
    "languages_spoken": [
      "de",
      "..."
    ],
    "check_in_time": "3:00 PM",
    "check_out_time": "11:00 AM",
    "gps_coordinates": {
      "latitude": 42.6557695064365,
      "longitude": 18.0736133028989
    },
    "url": "https://www.booking.com/hotel/hr/sumratin-dubrovnik.html",
    "thumbnail": "https://cf.bstatic.com/xdata/images/hotel/max500/842537117.jpg?k=6bd7c7d425ef3d74ea51d26e339e6aa8da9f630544d3e74022aa554231478e1c&o=&hp=1",
    "images": [
      "https://cf.bstatic.com/xdata/images/hotel/max1024x768/842537117.jpg?k=6bd7c7d425ef3d74ea51d26e339e6aa8da9f630544d3e74022aa554231478e1c&o=",
      "..."
    ]
  },
  "rooms": [
    {
      "position": 1,
      "name": "Deluxe Room with Park View and Balcony",
      "bed_configuration": "Select your bed (if available) 1 king bed 2 twin beds",
      "price": "$3,231",
      "extracted_price": 3231,
      "currency": "USD",
      "room_size": 34,
      "room_size_unit": "m²",
      "max_guests": 2,
      "max_children": 1,
      "bed_options": [
        [
          {
            "type": "extra_large_double_bed",
            "count": 1
          },
          "..."
        ],
        "..."
      ]
    },
    "..."
  ],
  "amenities": [
    {
      "name": "Outdoor swimming pool",
      "slug": "swimming_pool_2019_format",
      "value": "hotelfacility=433"
    },
    "..."
  ],
  "review_topics": [
    "Breakfast",
    "..."
  ],
  "review_summary": {
    "summarized_reviews": 28,
    "language": "en",
    "pros": [
      {
        "text": "Staff: Friendly, professional team provide helpful and attentive service.",
        "mentions": 19,
        "sentiment": "positive"
      },
      "..."
    ],
    "cons": [
      {
        "text": "Value: Attractive rates for a new hotel, though the spa and some services are unfinished.",
        "mentions": 7,
        "sentiment": "mixed"
      },
      "..."
    ]
  },
  "featured_reviews": [
    {
      "author": "Gary",
      "country_code": "gb",
      "title": "Amazing stay, great hotel/location",
      "liked": "Amazing location, attentive staff and excellent facilities.",
      "rating": 10.0,
      "travel_type": "Young Couple",
      "trip_type": "Leisure"
    },
    "..."
  ],
  "nearby_places": [
    {
      "category": "What's nearby",
      "places": [
        {
          "name": "Gradac Park",
          "type": "Urban Parks",
          "distance": "1.8 mi",
          "gps_coordinates": {
            "latitude": 42.641446,
            "longitude": 18.102609
          },
          "transportations": [
            {
              "type": "Walking",
              "duration": "38 min",
              "distance": "2 mi",
              "extracted_distance": 3224
            },
            "..."
          ]
        },
        "..."
      ]
    },
    "..."
  ],
  "nearby_beaches": [
    {
      "name": "Lapad Bay Beach",
      "distance": "900 feet",
      "rating": 8.3
    },
    "..."
  ],
  "meals": [
    {
      "type": "BREAKFAST",
      "styles": [
        "Buffet",
        "..."
      ],
      "cuisines": [
        "Continental",
        "..."
      ],
      "dietary_options": [
        "Vegetarian",
        "..."
      ]
    },
    "..."
  ],
  "fine_print": "The fine printMust-know information for guests at this propertySee availabilityThis property does not accommodate bachelor(ette) or similar parties.",
  "house_rules": {
    "check_in": "3:00 PM",
    "check_out": "11:00 AM",
    "age_restriction": "There's no age requirement for check-in",
    "parties": "Parties/events are not allowed",
    "group_policy": "When booking more than 5 rooms, different policies and additional fees may apply.",
    "payment_methods": [
      "American Express",
      "..."
    ],
    "is_cash_accepted": true,
    "children": {
      "are_children_allowed": true,
      "are_cribs_allowed": true,
      "are_extra_beds_allowed": true
    },
    "pets": {
      "charges": "not applicable"
    }
  },
  "faqs": [
    {
      "question": "Can I ask if you have Smart TVs in the room. Netflix etc? Thank you",
      "answer": "All of our rooms are equipped with Smart TVs. Kind regards, Hotel Sumratin, Guest Relations Team",
      "asked_date": "24 August 2026",
      "answered_date": "25 August 2026"
    },
    "..."
  ]
}

Nearby Places

The property surroundings grouped by category: What's nearby, Top attractions, Restaurants & cafes, Natural beauty, Public transport, Beaches and Closest airports, each place with its distance, GPS coordinates and best commute.

GET

https://www.searchapi.io/api/v1/search?adults=2&check_in_date=2026-10-02&check_out_date=2026-10-09&engine=booking_property&url=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fhr%2Fsumratin-dubrovnik.html