Booking Scraper

ENDPOINTS
GETHotel Details
GETAutocomplete
GETSearch Hotels
GETHotel Reviews
GET/booking/hotels/reviews

Hotel Reviews

One page of guest reviews for a property (25 per page) — score, title, positive/negative text, date, photos, guest profile and stay details — plus filter_options: the property's own filter values with counts. hotel_id is the numeric id every search result and details response carries as id.

QUERY PARAMS

Numeric Booking property id (from search/details responses).

Results page, 1-400 (25 reviews per page). Defaults to 1.

Review order. Defaults to most_relevant.

Only reviews from this traveler type.

Only reviews in this score bucket: wonderful (9+), good (7-9), fair (5-7), poor (3-5), very_poor (1-3).

Only reviews written in this language (2-letter code). The property's available languages are listed in filter_options.languages.

Only reviews from stays in this season.

Free-text search within the review texts.

Only reviews about this topic (Room, Clean, Breakfast, ...). The property's topic ids are listed in filter_options.topics.

Booking language code — sets the response language. Defaults to en-us.

{
  "count": 0,
  "per_page": 25,
  "current_page": 1,
  "total_pages": 0,
  "next": null,
  "previous": null,
  "hotel_id": 52186,
  "locale": "en-us",
  "sort_by": "most_relevant",
  "filters": {
    "customer_type": null,
    "score": null,
    "language": "en",
    "time_of_year": null,
    "keyword": "breakfast",
    "topic_id": 245
  },
  "filter_options": {
    "customer_types": [
      {
        "value": "families",
        "name": "Families",
        "count": 0
      },
      {
        "value": "couples",
        "name": "Couples",
        "count": 0
      },
      {
        "value": "group_of_friends",
        "name": "Groups of friends",
        "count": 0
      },
      {
        "value": "solo_travellers",
        "name": "Solo travelers",
        "count": 0
      },
      {
        "value": "business_travellers",
        "name": "Business travelers",
        "count": 0
      }
    ],
    "scores": [
      {
        "value": "wonderful",
        "name": "Wonderful: 9+",
        "count": 0
      },
      {
        "value": "good",
        "name": "Good: 7-9",
        "count": 0
      },
      {
        "value": "fair",
        "name": "Fair: 5-7",
        "count": 0
      },
      {
        "value": "poor",
        "name": "Poor: 3-5",
        "count": 0
      },
      {
        "value": "very_poor",
        "name": "Very Poor: 1-3",
        "count": 0
      }
    ],
    "languages": [],
    "times_of_year": [
      {
        "value": "mar_may",
        "name": "Mar–May",
        "count": 0
      },
      {
        "value": "jun_aug",
        "name": "Jun–Aug",
        "count": 0
      },
      {
        "value": "sep_nov",
        "name": "Sep–Nov",
        "count": 0
      },
      {
        "value": "dec_feb",
        "name": "Dec–Feb",
        "count": 0
      }
    ],
    "topics": []
  },
  "results": []
}