Agoda 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 Agoda API returns 20 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
offsetparameter.
To get reviews from Wextractor you will need to perform GET requests against
the https://wextractor.com/api/v1/reviews/agoda 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 | The full url(url encoded) of the hotel in agoda | https://www.agoda.com/pod-times-square/hotel/new-york-ny-us.html |
| 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/agoda?id=https%3A%2F%2Fwww.agoda.com%2Fpod-times-square%2Fhotel%2Fnew-york-ny-us.html&auth_token=XXXXX&offset=0
Example response:
{
"totals": {
"review_count": 586,
"average_rating": "8.5"
},
"reviews": [
{
"id": "914256060",
"datetime": "2025-01-12T01:44:00",
"text": "The rooms where very clean and nice but you only get a sheet and a blanket. The room is pretty small, we got the full pod. If you have too many big suitcases you probably won't fit. The area is a little sketchy but it is close everything.",
"title": "Clean rooms",
"reviewer": "Gabriela",
"rating": "7.2",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "903046868",
"datetime": "2024-12-14T08:51:00",
"text": "Price is reasonable considering the location is in times square. Stay there during thanksgiving with last minute booking.",
"title": "Location and price",
"reviewer": "Enny",
"rating": "10.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "902762660",
"datetime": "2024-12-10T11:23:00",
"text": "Hotel charged us for facilities charges and room deposit upon check in. Room deposit is supposed to be refunded after chk out. Almost 2 mos after and after several ff ups, no refund yet. 🥴Not sure for what facilities they're charging 🥴",
"title": "Still waiting for room deposit refund",
"reviewer": "PAULITA",
"rating": "7.6",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "897993167",
"datetime": "2024-11-26T10:09:00",
"text": "Accessible to all modes of transportation when going around Manhattan. Great Customer Service. Room space is adequate, cleaned everyday.",
"title": "Very Convenient",
"reviewer": "Rovielle",
"rating": "6.8",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "897652335",
"datetime": "2024-11-22T11:48:00",
"text": "The hotel is lovely! The location is great and central. The rooms are basic and very good, nice beds, nice shower:) \nI had a room on the 18floor and had a great view!",
"title": "Good, nice hotel with great location ",
"reviewer": "Stephanie",
"rating": "8.8",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "896964042",
"datetime": "2024-11-20T01:51:00",
"text": "I know its in the center but it is very pricey for its kind. Rooms are very small, ned is not comfy. They are not generous with toiletries and no enough space for luggages for 2 people.",
"title": "Above average",
"reviewer": "Chona",
"rating": "5.2",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "894920463",
"datetime": "2024-11-17T04:12:00",
"text": "sink was clogged the entire visit but honestly that was my only complaint. booked my next trip here while i was in the room. cant beat the location for theatre lovers. caught a great deal",
"title": "great deal/location",
"reviewer": "Richard",
"rating": "8.8",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "893842712",
"datetime": "2024-11-15T08:22:00",
"text": "The location was fantastic , make it easy to explore the city, near to subway station. The staff were friendly and helpful. The room is clean and well maintain, the staff clean the room everyday. Overall, its worth the price and comfortable experience.",
"title": "Very good",
"reviewer": "Catherine",
"rating": "8.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "893825838",
"datetime": "2024-11-15T05:18:00",
"text": "The hotel was very clean and quiet. For an overnight stay for work, this was perfect. It had everything I needed.",
"title": "Nice and Clean",
"reviewer": "Maria",
"rating": "8.8",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "893818529",
"datetime": "2024-11-15T04:13:00",
"text": "The location is near to almost all of the tourist attractions. \nThe room is also clean.",
"title": "Very good",
"reviewer": "Rizalina",
"rating": "7.2",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "893321585",
"datetime": "2024-11-10T08:35:00",
"text": "So don’t use the USB plug sockets next to the beds. I had my phone plugged in and my partner had his vape plugged in. When I took my phone out from leaving it plugged in overnight, it was extremely hot and then the screen completely greened out and had fried. My partners vape also not working. There had clearly been a power surge. This was a complete nightmare as it was only the second night of a 10 day travel adventure around America. Mid purchase of a new house back home and with my kids being at home, it was critical that I had my phone working, it also had all our hotel , travel and flights details for further travel. Had to spend a good part of short stay in NY wasted trying to get it fixed before catching a pre booked coach to Boston. Complete nightmare and cost me almost $300 to fix. There was a plug socket also under the desk hanging out of the wall with exposed wires. I wish I had taken pictures and had my phone not completely fried before we checked out I would have. My phone is just over 12 months old so almost brand new. I contacted the hotel after and they refused to respond and denied the plug socket hanging out the wall as I had no evidence.. basically calling me a liar.\n\nSuch a shame, as I thought it was a great hotel in a great area, but clearly it is not safe and cost more in iPhone repair and vape replacement than the room did. \n\nGutted",
"title": "Dangerous plug sockets will destroy your stuff",
"reviewer": "Katherine",
"rating": "2.8",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "893221131",
"datetime": "2024-11-09T04:15:00",
"text": "POD Times Square is exactly as advertised. They’re small, minimal amenities, but safe and in an amazing location for a quick theater trip! Would/will stay again.",
"title": "Great Solo Room For Short Trips",
"reviewer": "Leigh",
"rating": "8.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "889208952",
"datetime": "2024-11-05T10:15:00",
"text": "Staying right in the heart of midtown means you can maximise your time in NY, you can walk to any play/musical in the theatre district for under 10 minutes, right on the corner of 9th Ave with an abundance of eateries and Hell’s Kitchen entertainment. I will stay again, excellent value for money and the room was more spacious than I had imagined for New York.",
"title": "Maximise time in the city ",
"reviewer": "Simone",
"rating": "9.6",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "888674066",
"datetime": "2024-11-03T08:41:00",
"text": "Highly recommended hotel. Every part of my experience here was absolutely amazing. Great and helpful staff, clean room, great location and much more!",
"title": "Great Experience",
"reviewer": "Mohammed",
"rating": "10.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "886544062",
"datetime": "2024-10-31T07:03:00",
"text": "Exceptional, the room a little bit small but its enough, the sliding door might need a lock so it won’t open when we’re taking shower, after all its a good place while you looking for a convenient place to troll around the times square",
"title": "Exceptional",
"reviewer": "Dewinsya",
"rating": "10.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "879573007",
"datetime": "2024-10-13T11:32:00",
"text": "Very pleasant stay, staff was courteous and helpful. Room was clean and comfortable. I would like to come again and recommend.",
"title": "Great!!",
"reviewer": "Salman",
"rating": "9.2",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "879560070",
"datetime": "2024-10-13T09:15:00",
"text": "Happy stay",
"title": "Happy",
"reviewer": "Karmina",
"rating": "10.0",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "879496373",
"datetime": "2024-10-12T01:11:00",
"text": "Convenient location surrounded by eateries nearby. Small room but clean and has the basic stuff you need.",
"title": "Good CP value",
"reviewer": "Chen",
"rating": "9.6",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "879052211",
"datetime": "2024-10-07T12:13:00",
"text": "Compact rooms, perfect location if you want to stay near Times Square. Room is clean and baggage storage is available.",
"title": "So close to Times Square",
"reviewer": "Genievev",
"rating": "9.2",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
},
{
"id": "879038893",
"datetime": "2024-10-06T06:25:00",
"text": "Reasonable price at a good spot, 20 minutes from the Empire State building and 10 mins to Times Square.\nOnly downside is when the doors of neighboring rooms open and close, they sound like our room door and you have to check if someone entered. The security seemed good though, so no worries about intrusion.",
"title": "Good price, nothing lacking",
"reviewer": "ìœ ê²½",
"rating": "9.6",
"helpful_votes": 0,
"reply": {
"text": null,
"datetime": null
}
}
]
}
Frequently asked questions:
- How do I get all the reviews for a single place?
- Does the API have rate limits?
You need to perform multiple requests incrementing the offset until you get a response without any reviews in it.
Yes, since Agoda is pretty strict at blocking requests you will be rate limited if you perform more than ten requests per second.