Tripadvisor 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 Tripadvisor 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/tripadvisor 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 Tripadvisor. This identifier is a number that appears in the url for the hotel in tripadvisor. For example, if the url for the place in Tripadvisor is https://www.tripadvisor.com/Hotel_Review-g60763-d93437-Reviews-Hotel_Edison_Times_Square-New_York_City_New_York.html the identifier is the second number within the url: 93437 93437
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/tripadvisor?id=93437&auth_token=XXXXX&offset=0

Example response:

        {
            "reviews": [
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r780889406-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Doorstep of Times Square",
                    "text": "This place is all about the location. Glamorously positioned at the doorstep of time square. The hotel is cozy and comes with a bathtub. For the location, the hotel charges a fair price and is comparatively cheaper to the other establishments nearby. ",
                    "reviewer": "TravellingJerz",
                    "datetime": "2021-01-09T00:00:00Z",
                    "language": "en",
                    "id": "780889406"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r778437194-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "4",
                    "title": "Good location",
                    "text": "We stayed at the Edison during our trip to New York. We were happy with the location as it is a 1 minute walk away from times square and a subway station. \n\nThe rooms a basic but I think the hotel is in the middle of being re-vamped so we were in an older room but we weren’t bothered. The rooms were clean and the cleaners came in every day. \n\nWhen leaving they took our bags before we left for the airport so we could explore the city before leaving. They then called a taxi for us when leaving.",
                    "reviewer": "Frankie S",
                    "datetime": "2020-12-04T00:00:00Z",
                    "language": "en",
                    "id": "778437194"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r772650779-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Perfektes Hotel in New York",
                    "text": "Die Lage ist perfekt! Das Hotel ist ein richtiger New Yorker Hotel! Wir hatten ein Zimmer gebucht und leider war es ein zu lautes Zimmer für mich. Herr Gopez hat sich sofort bemüht, das beste Zimmer für uns auszusuchen. Schlussendlich, offerierte er uns eine wunderschöne Suite. Herr Gopez und sein Team haben unser Aufenthalt perfekt gemacht! Die Suite ist wunderschön, ruhig und mit eigenem Balkon. Einfach super! Reinigung ist trotz ein so grosses Hotel hervorragend. Bei unserer nächsten Reise in New York, werden wir auf jeden Fall wieder Hotel Edison wählen. Dankeschön!",
                    "reviewer": "Emma",
                    "datetime": "2020-10-01T00:00:00Z",
                    "language": "de",
                    "id": "772650779"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r770453073-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "4",
                    "title": "Excelente localizacao",
                    "text": "Hotel cumpre a proposta. \nSimples, pratico e aconchegante. Sem luxo, mas com limpeza e atendimento ótimos. \nFomos em uma época fria, e a calefação deu conta. \nUm ponto a mais para o bar de jazz que fica no hall. Espetacular. Drinks deliciosos, música espetacular. Atendimento muito bom. \nA localização do hotel é excelente, bem no meio da Big Apple! Perto de tudo. \nVale a pena. ",
                    "reviewer": "Ana Faria",
                    "datetime": "2020-09-15T00:00:00Z",
                    "language": "pt",
                    "id": "770453073"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r762533780-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Stornierung unseres Aufenthaltes im Dezember 2020",
                    "text": "Bereits mehrer Male waren wir im Hotel Edison und sind immer sehr zufrieden. Aufgrund der aktuellen Situation mussten/wollten wir unseren im Dezember 19 gebuchten (nicht erstattbaren) Aufenthalt für Dezember 2020 stornieren. Die Stornierung erfolgte sofort. Nach einem Mailverkehr wurde uns der ganze Aufenthalt rückerstattet und wir hatten das Geld innert 4 Tagen auf der Kreditkarte. Dafür möchte ich mich beim Hotel Edison ganz herzlich bedanken. Das ist Kundenservice. \nSobald es die Situation zulässt werden wir auf alle Fälle wieder das Hotel Edison buchen. Gerne wieder und bis bald....",
                    "reviewer": "Fabienne E",
                    "datetime": "2020-08-01T00:00:00Z",
                    "language": "de",
                    "id": "762533780"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r760828786-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "1",
                    "title": "Give it a miss",
                    "text": "Excellent location and that's the only positive thing I can say about the hotel. Hotel room was dark, drab and scruffy so was the bathroom. Worst hotel I've ever stayed in. The staff was so un helpful and the manager on shift well he's in the wrong job, no people skills, very rude and unhelpful. There's plenty of hotels in New York, I'm due to go back to New York absolutely love the city, but I definitely won't be going back there, that's a cert.",
                    "reviewer": "Ann P",
                    "datetime": "2020-07-20T00:00:00Z",
                    "language": "en",
                    "id": "760828786"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r760543748-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Best Christmas and New Years ",
                    "text": "What a great family vacation and The Edison was in part a big part of making our stay amazing. Location, location, location I just can’t say how conveniently located this property is to everything. It was less than a half block from time square  and walking distance to almost everything. Also easy to find transportation and never a shortage of great restaurants around including some good street food vendors for those late nights. Oh, also the gay bars were close just in case you were wondering. All in all a great hotel to stay if you’re looking to explore New York City.  Now, staff was amazing and the beds were very comfortable. Amenities within the property were great as they have a bar and  tow restaurants with great food. We were on higher floor so could not hear any noise. We were there through New Year’s And they had a special section for guest which made out New Years experience in NYC that much more special without having to stand outside all day.  This by far is my new favorite place to stay when going to New York.  I can’t wait to go again. ",
                    "reviewer": "Humberto R",
                    "datetime": "2020-07-18T00:00:00Z",
                    "language": "en",
                    "id": "760543748"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r759943032-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Florida Girls - Spring Break",
                    "text": "The people at the Edison treat us like VIPs every time we visit. Most the times were in March since as a teacher that’s my vacation time. My two friends and I enjoy the wonderful 2-room suite with plenty of room. Not only are we comfortable, but we feel safe. The security ( Danny, Jahaida, and others) and staff are so helpful in telling us what to watch for and where we should go while visiting. The Wine and Cheese evenings with local musicians in the lobby is a very special touch. If our flight is delayed and we check in at 3:00 am we still feel so very welcome. The Edison has been our NYC destination since 2014. Before that we stayed at different hotels, but none of them made the wonderful impression that the Edison did and it was the very special people who work there (Scott, Rommel, Roger, De’Marcus, and many others) that made us feel like family. The location is superb, so close to the many Broadway shows.",
                    "reviewer": "PennyM",
                    "datetime": "2020-07-13T00:00:00Z",
                    "language": "en",
                    "id": "759943032"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r759815899-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "Sencillamente espectacular",
                    "text": "Estuvimos en san valentin en 2016 y el hotel es un encanto en una ubicación inmejorable a unos 100metros de times square con unas vistas increibles... tuvimos un problema con la reserva de otro hotel ( equivocación del año de entrada por parte de la agencia de viajes) y tuvimos que buscarnos otro porque estaba lleno... buscando a pie con las maletas a cuestas encontramos el Edison y decir que nos atendieron magnificamente y la chica de recepción super profesional y buena gente nos alojó en una habitación superior a la que le pedimos. La estancia fué del 10. Uno de los días fuimos a ducharnos y no salía agua... se habían congelado por la ola de frío polar al estar casi en la última planta, nos dieron corriendo otra habitación para que nos ducháramos mientras arreglaban el problema. Lo recomendamos totalmente.\n\nMuchas gracias por hacernos el viaje más fácil 😊",
                    "reviewer": "Raúl Q",
                    "datetime": "2020-07-12T00:00:00Z",
                    "language": "es",
                    "id": "759815899"
                },
                {
                    "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d93437-r759757423-Hotel_Edison-New_York_City_New_York.html",
                    "rating": "5",
                    "title": "I miss my Edison family",
                    "text": "My visits at the Edison are among my favorite memories. I can never think of NYC without thinking of “my family” at the Edison, Scott, Danny, Rommel, Jahaida, De’Marcus, Roger and so many others. My first stay was in 2014 and I have always stayed there on every visit since. I found my NYC home. I always feel safe and loved when I am there. I hope to see everyone once it is safe to travel from Florida to NY.   Though, it may be awhile before we can actually come through the front door of the Edison and give you all big hugs, my friends and I think of you often. Getting back to the Edison is 1st on our post-COVID 19 list. Stay at the Edison, tell them Danny’s Angels sent you.",
                    "reviewer": "Paula C",
                    "datetime": "2020-07-12T00:00:00Z",
                    "language": "en",
                    "id": "759757423"
                }
            ],
            "totals": {
                "review_count": 13314,
                "average_rating": "3.79"
            }
        }
    

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 Tripadvisor is pretty strict at blocking requests you will be rate limited if you perform more than one request per second.