NAVNavbar
Logo
cURL php NodeJS Python cSharp

Get Business Data Tripadvisor Reviews Results by id

 
This endpoint provides feedback data on businesses listed on the Tripadvisor platform, including their locations, ratings, review content and count. The results are specific to the URL path indicated in the POST request.

We emulate set parameters with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is entirely relevant. Note that user preferences, search history, and other personalized search factors are ignored by our system and thus would not be reflected in the returned results.

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access

<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');

try {
   $result = array();
   // #1 - using this method you can get a list of completed tasks
   // GET /v3/business_data/tripadvisor/reviews/tasks_ready
   $tasks_ready = $client->get('/v3/business_data/tripadvisor/reviews/tasks_ready');
   // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
   if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
      foreach ($tasks_ready['tasks'] as $task) {
         if (isset($task['result'])) {
            foreach ($task['result'] as $task_ready) {
               // #2 - using this method you can get results of each completed task
               // GET /v3/business_data/tripadvisor/reviews/task_get/$id
               if (isset($task_ready['endpoint'])) {
                  $result[] = $client->get($task_ready['endpoint']);
               }
               // #3 - another way to get the task results by id
               // GET /v3/business_data/tripadvisor/reviews/task_get/$id
               /*
               if (isset($task_ready['id'])) {
                  $result[] = $client->get('/v3/business_data/tripadvisor/reviews/task_get/' . $task_ready['id']);
               }
               */
            }
         }
      }
   }
   print_r($result);
   // do something with result
} catch (RestClientException $e) {
   echo "n";
   print "HTTP code: {$e->getHttpCode()}n";
   print "Error code: {$e->getCode()}n";
   print "Message: {$e->getMessage()}n";
   print  $e->getTraceAsString();
   echo "n";
}
$client = null;
?>

The above command returns JSON structured like this:

{
    "version": "0.1.20240514",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.0866 sec.",
    "cost": 0,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "06131744-1535-0353-0000-934b4ae907a3",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.0202 sec.",
            "cost": 0,
            "result_count": 1,
            "path": [
                "v3",
                "business_data",
                "tripadvisor",
                "reviews",
                "task_get",
                "06131744-1535-0353-0000-934b4ae907a3"
            ],
            "data": {
                "api": "business_data",
                "function": "reviews",
                "se": "tripadvisor",
                "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
                "location_code": 1003854,
                "depth": 10,
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "url_path": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
                    "type": "tripadvisor_reviews",
                    "se_domain": "tripadvisor.com",
                    "check_url": "https://www.tripadvisor.com/Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
                    "datetime": "2024-06-13 14:44:19 +00:00",
                    "title": "Margaritaville Resort Times Square",
                    "location": null,
                    "reviews_count": 783,
                    "rating": {
                        "rating_type": "Max5",
                        "value": 4.5,
                        "votes_count": null,
                        "rating_max": 5
                    },
                    "rating_distribution": {
                        "1": 16,
                        "2": 14,
                        "3": 36,
                        "4": 69,
                        "5": 648
                    },
                    "items_count": 10,
                    "items": [
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 1,
                            "rank_absolute": 1,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r954702785-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 4,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-06-30 00:00:00 +00:00",
                            "timestamp": "2024-06-11 00:00:00 +00:00",
                            "title": "Oasis in Times Square",
                            "review_text": "Hotel was very nice and in a great location.  Very pleased with the decor and overall cleanliness.  Staff were very friendly and helpful as well.   The pool was so very nice, and I imagine a rarity in NYC to have an outdoor pool at a hotel.  \n\nMy only complaints are small, and not enough to keep me from staying again, but the service of the restaurant and bar staff was extremely slow, although the food was very good.  Perhaps they are short staffed, but everything took a very long time.  The only other complaint would be with the shower pressure.  A few of us had sporadic pressure with the pressure either slowing or stopping completely mid shower.\n\nAll in all, a pleasant stay, and would consider staying here again.",
                            "review_images": null,
                            "user_profile": {
                                "name": "Kathleen H",
                                "url": "https://www.tripadvisor.com/Profile/kathleenhC5040PD",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-f/01/2e/70/7c/avatar063.jpg",
                                "location": null,
                                "reviews_count": 10
                            },
                            "responses": null,
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "3"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "5"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 2,
                            "rank_absolute": 2,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r954505646-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 2,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-06-10 00:00:00 +00:00",
                            "title": "Le séjour bien mais OÙ EST MA CAUTION ????",
                            "review_text": "J’ai séjourné dans l’hôtel du 1er au 6 mai derniers, nous sommes le 10 juin et je n’ai toujours pas récupéré la caution de 300$ donnée à l’arrivée !!! Je ne cesse de contacter voyages privés, à ce jour, je n’ai toujours pas été remboursée !!! INADMISSIBLE",
                            "review_images": null,
                            "user_profile": {
                                "name": "Géraldine F",
                                "url": "https://www.tripadvisor.com/Profile/796g_raldinef",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/ee/68/default-avatar-2020-9.jpg",
                                "location": null,
                                "reviews_count": 9
                            },
                            "responses": null,
                            "review_highlights": null
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 3,
                            "rank_absolute": 3,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r954419823-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 5,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-06-30 00:00:00 +00:00",
                            "timestamp": "2024-06-09 00:00:00 +00:00",
                            "title": "THE BEST HOTEL IN NYC !!",
                            "review_text": "\"I recently stayed at Margaritaville Resort Times Square had a fantastic experience. The staff was incredibly friendly and accommodating, the room was spacious and clean, and the amenities were top-notch. The location was convenient, close to attractions and restaurants. I highly recommend this hotel for anyone visiting [NYC]!\"",
                            "review_images": [
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/85/df/67/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/85/df/68/caption.jpg"
                                }
                            ],
                            "user_profile": {
                                "name": "Jasmine M",
                                "url": "https://www.tripadvisor.com/Profile/jasminemE4527JK",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/ef/32/default-avatar-2020-12.jpg",
                                "location": null,
                                "reviews_count": 1
                            },
                            "responses": null,
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "5"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 4,
                            "rank_absolute": 4,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r954419784-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 5,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-06-30 00:00:00 +00:00",
                            "timestamp": "2024-06-09 00:00:00 +00:00",
                            "title": "Best birthday ever 💞",
                            "review_text": "Room was clean workers respectful and helpful beautiful view had a great time with my friends the best birthday ever \nGive these workers a raise 🎉🎉yayyyyyyytyyytyyytyyytyyytyyytytttttttyttytttttyyytyyytyyytyyytyyytyyytyyytyyy",
                            "review_images": null,
                            "user_profile": {
                                "name": "Hadassah B",
                                "url": "https://www.tripadvisor.com/Profile/43hadassahb",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/ed/00/default-avatar-2020-4.jpg",
                                "location": null,
                                "reviews_count": 1
                            },
                            "responses": null,
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "3"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "5"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 5,
                            "rank_absolute": 5,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r953720122-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 5,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-06-30 00:00:00 +00:00",
                            "timestamp": "2024-06-04 00:00:00 +00:00",
                            "title": "Cleanliness top-notch! ⭐️",
                            "review_text": "Stayed here for two nights for a concert at MSG - premium king room. Hotel design was tropical and lobby had the iconic blown-out flip flop.\n\nVery comfortable bed and pillows were big. I slept so well!!\n\nRobes and room slippers were given. Toothpaste and toothbrush available per request.\n\nRefrigerator nice & clean, complimentary water and coffee/coffee machine available. \n\nPool area and rooftop bar available but didn’t go to those.\n\nLocation: 10/10 - minutes walk from landmarks and nearby port authority bus station/subways. Only 10 minutes walk from the concert venue. Multiple restaurants/deli/stores\n\nCleanliness: 100/10 Very clean room, even the bathroom floor was spotless, plus the windows were clean as well. \n\nStaff: Very friendly staff, from lobby to housekeeping.\n\nWill recommend this hotel!!",
                            "review_images": [
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/fc/71/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/f9/5b/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/f9/5a/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/f9/59/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/f9/58/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/7a/f9/57/caption.jpg"
                                }
                            ],
                            "user_profile": {
                                "name": "Aggy",
                                "url": "https://www.tripadvisor.com/Profile/aggy28",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f4/20/default-avatar-2020-31.jpg",
                                "location": null,
                                "reviews_count": 6
                            },
                            "responses": null,
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "5"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 6,
                            "rank_absolute": 6,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r952904865-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 1,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-05-29 00:00:00 +00:00",
                            "title": "STOP and read this, DO NOT GO!",
                            "review_text": "My husband and I have always been great fans of Jimmy Buffet and the Margaritaville restaurants.  We try and visit one on every vacation, Hawaii, Las Vegas (sad it is closing soon), etc. While in New York last week, we made the special trip to visit Margaritaville off of Times Square, my husband even wore his Margaritaville Hawaiian shirt!  \n\nAs we arrived, we were told to head to the 3rd floor for Happy Hour.  We sat for 30 minutes without even being acknowledged, although staff and what seemed to be management walked by numerous times.  We left very frustrated and decided to try the roof-top-bar.  Staff directed us and two other couples to an elevator down the hall to get to the roof-top-bar.  We stood in the elevator watching the doors continually open and close.  We returned to front to ask staff if there was problem with the elevator, only to be told to gain access to the roof-top-bar, a staff member must first scan into the elevator.  Why would they not do this first when they knew where we were going and directed us that way?  One couple simple left, and my biggest regret in life is that we did not follow!  Our dilemma did not end there, it only continued.  After 1 hour (again no service, and little staff, we needed to go to the bar ourselves, but I will not dwell on this issue), we decided to return to the second floor for dinner.  The restaurant was 90% empty, as it was only 5pm, but we were told it would be a 20 minute wait for a table and that we should sit at the bar.  Staff asked for our cell phone number and would text in 20 minutes to advise that our table was ready.  We sat in an empty restaurant waiting for a table, watching a ton of staff walk around bored.  To make matters worse, while we waited at the bar, we received NO service.  Again staff walking around but no one acknowledged us or offered to take our drink orders.  After 30 minutes, very very disappointed we left.  We walked directly across the street to Yard House….were seated immediately and had one of the best meals of our lives and the staff was amazing! After one hour, I contact Margaritaville to inquire when our table would be ready, as their 20 minutes had long passed.  I received a text back, 30 minutes later, stating that if we did not arrive within 6 minutes our table would be given away.  We have never experienced such poor service ever at a Margaritaville, and although big fans, we have vowed to never return again.  A truly sad story with no happy ending.  Shame on you Margaritaville in New York!",
                            "review_images": null,
                            "user_profile": {
                                "name": "Shantel M",
                                "url": "https://www.tripadvisor.com/Profile/451shantelm",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/f2/11/default-avatar-2020-23.jpg",
                                "location": null,
                                "reviews_count": 1
                            },
                            "responses": null,
                            "review_highlights": null
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 7,
                            "rank_absolute": 7,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r952573553-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 4,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-05-27 00:00:00 +00:00",
                            "title": "Great location",
                            "review_text": "The location is fantastic, rooms are good and staff friendly. The rooftop bar is great and the views gorgeous. BUT if you have dietary restrictions I would avoid the restaurants, staff didn’t know anything about how food was made or ingredients offerings are limited and even when the food is identified as dietary/allergy they will mess it up and come with not appropriate sides .",
                            "review_images": null,
                            "user_profile": {
                                "name": "Vacation33720136714",
                                "url": "https://www.tripadvisor.com/Profile/Vacation33720136714",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/1a/f6/ed/ce/default-avatar-2020-7.jpg",
                                "location": null,
                                "reviews_count": 2
                            },
                            "responses": null,
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "4"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 8,
                            "rank_absolute": 8,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r952231152-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 4,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-05-24 00:00:00 +00:00",
                            "title": "Good for first timers",
                            "review_text": "On our first trip to New York City we were overall happy with this hotel. \n\nPros:\n- access to Times Square\n- quiet\n- clean\n- access to subway\n\nCons:\n- rooms are small ….. not a lot of  space to get to get to far side of the bed\n-  we ate at two of the restaurants. We would not recommend. Tacos from the Landshark Bar were terrible. \n- bartender “CJ” seemed to want to be at working anywhere but here\n- elevators are very very busy. Lots of waiting.",
                            "review_images": null,
                            "user_profile": {
                                "name": "Tango-7",
                                "url": "https://www.tripadvisor.com/Profile/Tango-7",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-o/0a/46/bd/1e/tango-7.jpg",
                                "location": null,
                                "reviews_count": 117
                            },
                            "responses": null,
                            "review_highlights": null
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 9,
                            "rank_absolute": 9,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r950857748-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 4,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-05-14 00:00:00 +00:00",
                            "title": "Great location!",
                            "review_text": "First time staying at this property (2 couples in 50's).  Great location. 2 blocks from times square & broadway.  4 blocks from Penn Station, MSG.  2  Can actually see NY eve ball drop from License to chill bar, margaritvalle restaurant, 5 o'clock somwhere bar.  doors available to enter from 7th ave.  one has escalator that takes you to 2nd and 3rd floor which is where Margaritaville restaurant is located.  the other takes you to bank of 4 elevators that takes you to check in and the rooms.  Registration is on floor 7 as is License to Chill bar.  You must use your key cards in all elevators to go up beyond the 7th floor.  Unless you just want to go to the rooftop 5 o'clock somewhere bar on 31st and 32nd floor.  access to restaurants and bars is set up so anyone can get to them regardless if staying in hotel. Landshark bar and grille is on 4th floor adjacent to outdoor pool.  They have a coffee, soft drinks, snacks, etc shop just opposite the check in desk on 7th floor.  Rooms are OK.  typical NY size (small).  But we had a king bed and a huge Flat screen TV.  Mattress and pillows were like marshmallows.  Not my cup of tea, but couple we traveled with who typically sleep on soft mattress had no complaints. Complimentary coffee and water.  Free Safe.  Bathroom small, not a ton of shelf space  but enough to get bar.  Shower stall has the Carribean style 1/2 door.  so if your not a small person water splashes outside onto bathroom floor.  annoying that hotels do this when the actual show is only 5 feet in length.  water pressure OK.  always had hot water. we had view looking south onto 40th street and beyond from the 11th floor.  decor is beach/Buffet themed as you would imagine.  piped in music in halls, elevators etc is all JB or beach themed.  \nIf you are not a fan of JB don't stay here.  plenty of similarly priced options nearby.  Rooms clean and since redone to Margaritaville Resort in 2020 in good shape.  Big Jimmy Buffet fan but that being said would not stay here again.  Prefer one of his ocean front properties.  Ate at Margaritaville Restaurant and Land shark bar and grille during our stay.  Typical food at these themed restaurants, was hot and tasty, nothing fancy.",
                            "review_images": [
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-m/1280/2c/2d/16/b5/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-m/1280/2c/2d/16/d9/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/2d/17/18/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/2d/17/77/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/2d/17/b6/caption.jpg"
                                },
                                {
                                    "url": "https://media-cdn.tripadvisor.com/media/photo-w/2c/2d/17/d6/caption.jpg"
                                }
                            ],
                            "user_profile": {
                                "name": "bri11164",
                                "url": "https://www.tripadvisor.com/Profile/bri11164",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-m/1280/1b/e8/6f/24/bri11164.jpg",
                                "location": "Bridgewater, Massachusetts",
                                "reviews_count": 648
                            },
                            "responses": [
                                {
                                    "title": "Ciera Wheatley",
                                    "text": "Thank you for sharing your detailed review of your stay at the property. It's wonderful to hear that you found the location to be great and convenient for exploring New York City. Your insight into the amenities and layout of the hotel are very helpful for future guests. We appreciate your feedback on the rooms, restaurants, and overall experience. Your honest assessment will surely assist others in making informed decisions about their stay. Thank you for choosing to stay with us and for taking the time to provide you feedback. \n\nCiera Wheatley \nciera.wheatley@margaritavilleresortnyc.com \nDirector of Front Office ",
                                    "timestamp": "2024-05-15 00:00:00 +00:00"
                                }
                            ],
                            "review_highlights": [
                                {
                                    "feature": "Value",
                                    "assessment": "3"
                                },
                                {
                                    "feature": "Rooms",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Location",
                                    "assessment": "5"
                                },
                                {
                                    "feature": "Cleanliness",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Service",
                                    "assessment": "4"
                                },
                                {
                                    "feature": "Sleep Quality",
                                    "assessment": "3"
                                }
                            ]
                        },
                        {
                            "type": "tripadvisor_review_search",
                            "rank_group": 10,
                            "rank_absolute": 10,
                            "position": "left",
                            "url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r950037128-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
                            "rating": {
                                "rating_type": "Max5",
                                "value": 5,
                                "votes_count": null,
                                "rating_max": 5
                            },
                            "date_of_visit": "2024-05-31 00:00:00 +00:00",
                            "timestamp": "2024-05-08 00:00:00 +00:00",
                            "title": "Very pleasant surprise",
                            "review_text": "Rooms, while small, were well appointed and very clean. Staff was very friendly and helpful. Many little touches that made our stay there very good. We would definitely return. \n\nOnly disappointment was the restaurant which was just okay, but there are plenty of other restaurants in the area to choose from.",
                            "review_images": null,
                            "user_profile": {
                                "name": "thorgan",
                                "url": "https://www.tripadvisor.com/Profile/thorgan",
                                "image_url": "https://media-cdn.tripadvisor.com/media/photo-s/09/a0/2d/92/thorgan.jpg",
                                "location": "Westborough, Massachusetts",
                                "reviews_count": 130
                            },
                            "responses": [
                                {
                                    "title": "Ciera Wheatley",
                                    "text": "It's fantastic to hear that you had a pleasant stay! A well- appointed and clean room, along with friendly and helpful staff, can truly make a difference in your overall experience. Thank you for sharing your feedback about the restaurant, we will be sure to share with our partners in Food and Beverage to review. We hope to welcome you back again soon! \n\nCiera Wheatley \nciera.wheatley@margaritavilleresortnyc.com \nDirector of Front Office ",
                                    "timestamp": "2024-05-15 00:00:00 +00:00"
                                }
                            ],
                            "review_highlights": null
                        }
                    ]
                }
            ]
        }
    ]
}

Description of the fields for sending a request:

Field name Type Description
id string task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time

‌‌‌‌
‌‌As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

You can also get all available SERP features by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/business_data/tripadvisor/reviews/task_get/00000000-0000-0000-0000-000000000000
The response will include all available items in the TripAdvisor Reviews endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.

Description of the fields in the results array:

Field name Type Description
version string the current version of the API
status_code integer general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message string general informational message
you can find the full list of general informational messages here
time string execution time, seconds
cost float total tasks cost, USD
tasks_count integer the number of tasks in the tasks array
tasks_error integer the number of tasks in the tasks array that were returned an error
tasks array array of tasks
        id string task identifier
unique task identifier in our system in the UUID format
        status_code integer status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here
        status_message string informational message of the task
you can find the full list of general informational messages here
        time string execution time, seconds
        cost float cost of the task, USD
        result_count integer number of elements in the result array
        path array URL path
        data object contains the same parameters that you specified in the POST request
        result array array of results
            url_path string URL path received in a POST array
            type string search engine type in a POST array
            se_domain string search engine domain in a POST array
            check_url string direct URL to search engine results
you can use it to make sure that we provided accurate results
            datetime string date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
            title string title of the ‘reviews’ element in SERP
the name of the local establishment for which the reviews are collected
            location string location of the local establishment
address of the local establishment for which the reviews are collected
            reviews_count integer the total number of reviews
            rating object rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP
                rating_type string type of rating
here you can find the following elements: Max5, Percents, CustomMax
                value float the average rating based on all reviews
                votes_count integer the number of votes
                rating_max integer the maximum value for a rating_type
            rating_distribution object rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5
                1 integer votes for the 1-point rating
                2 integer votes for the 2-points rating
                3 integer votes for the 3-points rating
                4 integer votes for the 4-points rating
                5 integer votes for the 5-points rating
            items_count integer the number of reviews items in the results array
you can get more results by using the depth parameter when setting a task
            items array found reviews
you can get more results by using the depth parameter when setting a task
                type string the review’s type
possible review types: "tripadvisor_review_search"
                rank_group integer position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group
                rank_absolute integer absolute rank among all the listed reviews
absolute position among all reviews on the list
                position string the alignment of the review in SERP
can take the following values: right
                url string URL of the review
                rating object the rating score submitted by the reviewer
                  rating_type string the type of the rating
can take the following values: Max5
                  value float the value of the rating
                  votes_count integer the amount of feedback
in this case, the value will be null
                  rating_max integer the maximum value for a rating_type
the maximum value for Max5 is 5
                date_of_visit string date of the reviewer’s visit to the local establishment
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                timestamp string date and time when the review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                title string title of the review
                review_text string content of the review
                review_images array contains URLs of the images used in the review
                    url string URL of the image used in the review
                user_profile object information from the reviewer’s profile
                    name string reviewer’s profile name
                    url string URL of the reviewer’s profile
                    image_url string URL of the reviewer’s profile image
                    location string URL of the reviewer’s profile image
                    reviews_count string total number of reviews submitted by the reviewer
                responses array contains information about the owner’s response
                    title string title of the owner’s response
indicates the owner’s name
                    text string text of the owner’s response
                    timestamp string date and time when the response was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                review_highlights array review highlights
contains highlighted review criteria and assessments
                    feature string reviewed feature
                    assessment string feature assessment

‌‌