Booking reviews API documentation

We provide a simple to setup REST API that returns reviews in JSON format. Before integrating the API you should be aware of the following:

  • The Booking API returns 10 reviews per request.
  • The order in which reviews are returned is by descending date(from newest to oldest).
  • You can get all reviews from a single place by using the offset parameter.

To get reviews from Wextractor you will need to perform GET requests against the https://wextractor.com/api/v1/reviews/booking endpoint.

Reviews endpoint parameters:

Parameter Required Description Example
auth_token Required Your API token for authentication. Once you register to Wextractor you can extract this key from your account's setting page. -
id Required A textual identifier that uniquely identifies a place in Booking. This identifier is a part of the path that appears in the url for the hotel in booking, this includes the country code for the place and the internal id in booking. For example, if the url for the place in booking is https://www.booking.com/hotel/us/hi-new-york-hostel-nyc.en-gb.html the identifier is: us/hi-new-york-hostel-nyc us/hi-new-york-hostel-nyc
offset Optional This parameter defines the result offset. It skips the given number of reviews. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.). 10

Example usage:

https://wextractor.com/api/v1/reviews/booking?id=us/hi-new-york-hostel-nyc&auth_token=XXXXX&offset=0

Example response:

        {
            "reviews": [
                {
                    "id": "b7712df439c8d18e",
                    "reviewer": "Rodrigo",
                    "reviewer_avatar": "https://graph.facebook.com/v2.9/998175500233914/picture?type=square&height=64&width=64",
                    "rating": "9.0",
                    "pros": "the location is excelent. the staff and the cleaners are helpfull. the building is imense and has a good kitchen and living rooms. the bathrooms are very good.",
                    "cons": "There were  problems with the air conditioning. At the same time was common to guests turn off the AC in shared rooms. I think the Hostel should instruct the guests to no do this and, instead, just look for one more blanket. This happended to me and the staff promptly gave me another blanket. In shared rooms people must get used to or wear more clothes instead of just turn off the entire room’s ventilation.",
                    "title": "the best value in you can get in Manhattan",
                    "language": "en",
                    "datetime": "2022-07-01 00:00:00"
                },
                {
                    "id": "2165054d51fe408e",
                    "reviewer": "João",
                    "reviewer_avatar": "https://graph.facebook.com/v2.9/10206614135648492/picture?type=square&height=64&width=64",
                    "rating": "6.0",
                    "pros": "Simpatia dos funcionários.\nZona de lazer com espaço verde e bar com boa diversidade de alimentos e bebidas.",
                    "cons": "O ar condicionado fazia muito barulho, parecendo que tinha peças soltas, o que me impedia de descansar.\nNão teve água quente durante 3 dias.\nOs lençóis atribuídos tinham cabelos e não passados a ferro, parecendo usados (mas as restantes camas estavam bem, pode ter sido um erro momentâneo).",
                    "title": "Pleasant",
                    "language": "pt",
                    "datetime": "2022-08-01 00:00:00"
                },
                {
                    "id": "9c7b5ce069c88fc8",
                    "reviewer": "Juan",
                    "reviewer_avatar": "https://cf.bstatic.com/static/img/review/avatars/ava-j/f69a0f45af414641ac0371c1f139c49637969c6c.png",
                    "rating": "10",
                    "pros": "",
                    "cons": "",
                    "title": "Exceptional",
                    "language": "",
                    "datetime": "2022-07-01 00:00:00"
                },
                {
                    "id": "a1b02ab862bb8a59",
                    "reviewer": "Taynara",
                    "reviewer_avatar": "https://lh3.googleusercontent.com/-6P464Bf0UqA/AAAAAAAAAAI/AAAAAAAAAAA/ACHi3rcWSJiwQvzRy661igTa2cp-83m-nA/mo/photo.jpg",
                    "rating": "8.0",
                    "pros": "a estrutura de modo geral é muito boa mas a limpeza dos banheiros podia ser melhor.",
                    "cons": "limpeza dos banheiros, limpeza dos quartos e ar condicionado com baixa vazão.",
                    "title": "Very good",
                    "language": "pt",
                    "datetime": "2022-08-01 00:00:00"
                },
                {
                    "id": "6b41c374de120008",
                    "reviewer": "Zakaria",
                    "reviewer_avatar": "https://q-xx.bstatic.com/xdata/images/xphoto/square64/138427501.jpg?k=66ad7b5b9da5061204af2d110db852d1461f26db8f43106154fd648d01a07fe7&o=",
                    "rating": "1.0",
                    "pros": "I felt like in a prison",
                    "cons": "",
                    "title": "Bad",
                    "language": "no",
                    "datetime": "2022-05-01 00:00:00"
                },
                {
                    "id": "da3a893fcf5f0dcd",
                    "reviewer": "Anonymous",
                    "reviewer_avatar": "https://cf.bstatic.com/static/img/review/avatars/ava-a/2c7be68fb3f987f1352e7b289d4b24137e1a283d.png",
                    "rating": "10",
                    "pros": "",
                    "cons": "",
                    "title": "Exceptional",
                    "language": "",
                    "datetime": "2022-07-01 00:00:00"
                },
                {
                    "id": "1d3c62cb147ecc38",
                    "reviewer": "Jerome",
                    "reviewer_avatar": "https://cf.bstatic.com/static/img/review/avatars/ava-j/f69a0f45af414641ac0371c1f139c49637969c6c.png",
                    "rating": "5.0",
                    "pros": "",
                    "cons": "",
                    "title": "Lieu impersonnel, manque d'animation",
                    "language": "",
                    "datetime": "2022-07-01 00:00:00"
                },
                {
                    "id": "5444a4f61d4e4071",
                    "reviewer": "Bianca",
                    "reviewer_avatar": "https://cf.bstatic.com/static/img/review/avatars/ava-b/8103dfb0481c4cedc201d849f5666a270512f538.png",
                    "rating": "1.0",
                    "pros": "",
                    "cons": "",
                    "title": "Bad",
                    "language": "",
                    "datetime": "2022-06-01 00:00:00"
                },
                {
                    "id": "84a1de28500259e1",
                    "reviewer": "Nicola",
                    "reviewer_avatar": "https://graph.facebook.com/v2.9/957980564212919/picture?type=square&height=64&width=64",
                    "rating": "10",
                    "pros": "",
                    "cons": "",
                    "title": "Exceptional",
                    "language": "",
                    "datetime": "2022-08-01 00:00:00"
                },
                {
                    "id": "b0cc0276832ebc26",
                    "reviewer": "Rafael",
                    "reviewer_avatar": "https://cf.bstatic.com/static/img/review/avatars/ava-r/29d5c93ac6953138bfc6f214a4c5a0f8b712b57b.png",
                    "rating": "10",
                    "pros": "",
                    "cons": "",
                    "title": "Exceptional",
                    "language": "",
                    "datetime": "2022-07-01 00:00:00"
                }
            ]
        }
    

Frequently asked questions:

  • How do I get all the reviews for a single place?
  • You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.

  • Does the API have rate limits?
  • Yes, since Expedia is pretty strict at blocking requests you will be rate limited if you perform more than one request per second.