NAVNavbar
Logo
cURL php NodeJS Python cSharp

Get Business Data Google Reviews Results by id

 
The returned results are specific to the indicated local establishment name, search engine, location and language parameters. We emulate set location and search engine 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-dashboard

<?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-dashboard
$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/google/reviews/tasks_ready
   $tasks_ready = $client->get('/v3/business_data/google/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/google/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/google/reviews/task_get/$id
               /*
               if (isset($task_ready['id'])) {
                  $result[] = $client->get('/v3/business_data/google/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.20220216",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0723 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "03072148-1535-0298-0000-9c41dfc2e576",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0189 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "business_data",
        "google",
        "reviews",
        "task_get",
        "03072148-1535-0298-0000-9c41dfc2e576"
      ],
      "data": {
        "se_type": "reviews",
        "se": "google",
        "api": "business_data",
        "function": "reviews",
        "location_name": "London,England,United Kingdom",
        "language_name": "English",
        "keyword": "hedonism wines",
        "depth": 10,
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "keyword": "hedonism wines",
          "type": "google_reviews",
          "se_domain": "google.co.uk",
          "location_code": 1006886,
          "language_code": "en",
          "check_url": "https://www.google.co.uk/search?q=hedonism%20wines&num=10&sort=qualityScore&hl=en&gl=GB&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS",
          "datetime": "2022-03-07 19:48:46 +00:00",
          "title": "Hedonism Wines",
          "sub_title": "3-7 Davies St, London",
          "rating": {
            "rating_type": "Max5",
            "value": 4.8,
            "votes_count": null,
            "rating_max": 5
          },
          "feature_id": "0x4876052ce9c2190f:0x4e1505095325804d",
          "place_id": "ChIJDxnC6SwFdkgRTYAlUwkFFU4",
          "cid": "5626408847077113933",
          "reviews_count": 877,
          "items_count": 10,
          "items": [
            {
              "type": "google_reviews_search",
              "rank_group": 1,
              "rank_absolute": 1,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[1]",
              "review_text": "Their staff were really helpful as well and actually came out of the shop and offer to help you take photographs.",
              "original_review_text": null,
              "time_ago": "a month ago",
              "timestamp": "2022-02-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 447,
              "photos_count": 3857,
              "local_guide": true,
              "profile_name": "na p.",
              "profile_url": "https://www.google.com/maps/contrib/110397550682740157102?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBF",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GiJR27Y35FA8Bzf2qwlgfjHpXQhX-7rCRPx1PPH=s40-c-c0x00000000-cc-rp-mo-ba6-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 2,
              "rank_absolute": 2,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[2]",
              "review_text": "A temple to wine where you'll find your special ultra rare and premium bottle for that special occasion or a fine tipple for evening drinks. Worth going in if just to catch the theatre of it. Every time we visited we are greeted with with a unique art display to welcome us. Once in you will see wines available from the every-day to the obscene, and more if you ask the friendly and very knowledgeable staff.\nGreat whites, fizz, spirits and glassware on the ground floor. Down the iron steps you descend into the world of the Domaine de la Romanée-Contis, Rothschilds, Quintarellis, Sine Qua Nons to name but a few, many in Salamanzar, Balthazar, Nebuchanezzar and other biblical (literally) sizes for you to admire in awe (look at the price tags if you dare).\nBut probably the best feature is the row of Enomatic machines with an ever changing range of fine wines for you to sample (at a reasonable cost), which allows you to explore wines that you wouldnt find elsewhere without having to buy a while bottle first. Wanted to try that d'Yquem, Figeac or Sine Qua Non to see what the fuss is about? They've got you covered.",
              "original_review_text": null,
              "time_ago": "4 months ago",
              "timestamp": "2021-11-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 40,
              "photos_count": 82,
              "local_guide": true,
              "profile_name": "Dan Ma",
              "profile_url": "https://www.google.com/maps/contrib/112822637485884602580?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBW",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhaukE-S6tTrCuca7_t0tkncZAJaDsbHQYCvOi5LQ=s40-c-c0x00000000-cc-rp-mo-ba5-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 3,
              "rank_absolute": 3,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[3]",
              "review_text": "I have visited many high level wine stores in my life, specially in EUA. It's hard to have proper words to define the experience Hendonism have offered to me. From the core, the variety of wines and champagnes are simply exceptional. Yes, you can find from affordable wines until very high level and expensive ones - depending on the size of your pocket. What I should mention as well is that the wines are not the only incredible attraction here. Their architecture, the very kind staff and amazing decorations transform your visiting in a unbeatable experience. So, if you enjoy different wines, nice hanging, and different high level experiences, please its mandatory to visit this store.",
              "original_review_text": null,
              "time_ago": "6 months ago",
              "timestamp": "2021-09-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 130,
              "photos_count": 1476,
              "local_guide": true,
              "profile_name": "Rubens Cury",
              "profile_url": "https://www.google.com/maps/contrib/103889894448456747782?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARBo",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Ghkdbh4uaLAkY5hCkTXPa_M46iosdVtyMYfUWvZI9A=s40-c-c0x00000000-cc-rp-mo-ba6-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 4,
              "rank_absolute": 4,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[4]",
              "review_text": "After the many times I have been inside this beautiful wine paradise, it is time for me to share my experience. The store is a must visit for anybody having an interest in wine, the decoration is just superb and they have such an amazing variety you will never want to try the same bottle twice.\nThe staff is super friendly and super helpful. Although every single employee makes you feel very welcome, I would like to mention these three guys who have made my experience always fantastic.\nOliver: super friendly and energetic Hungarian guy he has given me really amazing recommendations. He will spend hours discussing what are the most suitable options for you.\nTom: he is really polite and knowledgeable, answered my most nonsense questions and helped me with my first ever purchase in the store.\nJames H. : Helped me with my Rosé. He was very patient answering my 1000 questions I had about wine. You can see he has a big passion for the industry and let me with some really nice recommendations.\nHedonism has literally become my second house, showing up every second week. So is not only the place that makes you want to return but the people who works there, in their very charming way they will always make you come for more.",
              "original_review_text": null,
              "time_ago": "a year ago",
              "timestamp": "2021-03-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 6,
              "photos_count": 10,
              "local_guide": false,
              "profile_name": "isabel Rey-joly",
              "profile_url": "https://www.google.com/maps/contrib/103418445528667943173?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegQIARB7",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Gjd7uc6usiVwwLfT2FC4jZHrycQn5Tcc0Yzb1thOQ=s40-c-c0x00000000-cc-rp-mo-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 5,
              "rank_absolute": 5,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[5]",
              "review_text": "A seriously extensive range of wine and other alcohol! Spread over two floors with a beautiful interior with little nooks in the wine cellar that illuminate when entering.\nThe staff are super pleasant and are willing to help anyone with a question! I’ve purchased a few items from here and each time I’ve left with something truly fantastic.\nFor the location and expertise this place is very well priced and located in a great area of London.\nThey also do really cool window/shop displays all year round which are worth visiting in its self.\nGo and have a visit!",
              "original_review_text": null,
              "time_ago": "a year ago",
              "timestamp": "2021-03-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 212,
              "photos_count": 1847,
              "local_guide": false,
              "profile_name": "Aaron Ghastkill",
              "profile_url": "https://www.google.com/maps/contrib/111282053100911487339?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCMAQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14Gju1lqicmeOfVasG2zpIZPtnO_UwU1aD946O6mbbQ=s40-c-c0x00000000-cc-rp-mo-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 6,
              "rank_absolute": 6,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[6]",
              "review_text": "Quality and expertise have of course a price. I order frequently online, till now have no problems and the delivery is fast. Nothing short of 5 stars. Many thanks to Charikleia for her top service and consultation, I am looking forward to visiting the boutique when I am in London!",
              "original_review_text": null,
              "time_ago": "2 months ago",
              "timestamp": "2022-01-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 20,
              "photos_count": 1,
              "local_guide": true,
              "profile_name": "Nikolaos Mavromatis",
              "profile_url": "https://www.google.com/maps/contrib/101686730279233872358?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCiAQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GgdiVhUDnRHyf4ZF2L5ZW_NVSdTQLsMQaQ2Qut36g=s40-c-c0x00000000-cc-rp-mo-ba3-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 7,
              "rank_absolute": 7,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[7]",
              "review_text": "I recommend this exit to everyone through the Hedonism Wines shop, Scotch whiskey, an incredible aroma...🤙👁️🥃⚓🎨🖼️🎻",
              "original_review_text": null,
              "time_ago": "a month ago",
              "timestamp": "2022-02-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 8,
              "photos_count": 21,
              "local_guide": false,
              "profile_name": "Dmitriy Afanasiev",
              "profile_url": "https://www.google.com/maps/contrib/108095039253712175738?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARCtAQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhGpRmaf1TG5h2G-CVZAR_RRHSj6tyqyvXbh9Az=s40-c-c0x00000000-cc-rp-mo-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 8,
              "rank_absolute": 8,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[8]",
              "review_text": "I can’t believe I stumbled across this place once and now I have some where to go for great wines and whiskey… they have a massive collection of spirts, and the staff are always around to help out. I will definitely be returning",
              "original_review_text": null,
              "time_ago": "a month ago",
              "timestamp": "2022-02-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 2,
              "photos_count": null,
              "local_guide": false,
              "profile_name": "Rachael Kersey",
              "profile_url": "https://www.google.com/maps/contrib/112361837437762206097?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARC6AQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GiKoCZBKmtNSxO6pj7uQB13E0bHaZzhmkjQMV75tg=s40-c-c0x00000000-cc-rp-mo-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 9,
              "rank_absolute": 9,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[9]",
              "review_text": "Amazing staff and fantastic collection of spirits, wines and champagne!",
              "original_review_text": null,
              "time_ago": "2 months ago",
              "timestamp": "2022-01-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 21,
              "photos_count": 6,
              "local_guide": true,
              "profile_name": "Vlad Hudges",
              "profile_url": "https://www.google.com/maps/contrib/109828475292354440876?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARDFAQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GhZ0fFD6Bs7pG1pMcC31yamyjvkOc3_vZCOstFdWg=s40-c-c0x00000000-cc-rp-mo-ba2-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null
            },
            {
              "type": "google_reviews_search",
              "rank_group": 10,
              "rank_absolute": 10,
              "position": "right",
              "xpath": "/div[1]/div[1]/div[2]/div[4]/div[1]/div[2]/div[10]",
              "review_text": "Best wine shop in London. Amazing selection and the atmosphere of the store is unreal. Plus the staff are very attentive.",
              "original_review_text": null,
              "time_ago": "a month ago",
              "timestamp": "2022-02-07 19:48:46 +00:00",
              "rating": {
                "rating_type": "Max5",
                "value": 5,
                "votes_count": null,
                "rating_max": 5
              },
              "reviews_count": 62,
              "photos_count": 89,
              "local_guide": true,
              "profile_name": "Diego Zamorano",
              "profile_url": "https://www.google.com/maps/contrib/109127697052844428117?hl=en-US&sa=X&ved=2ahUKEwi8j4e44rT2AhU6g3IEHVH9D80QvvQBegUIARDSAQ",
              "profile_image_url": "https://lh3.googleusercontent.com/a-/AOh14GjnLwgQRhxKTrM78wQPm61FUKJ6vjtvMpypwCtO_pc=s40-c-c0x00000000-cc-rp-mo-ba4-br100",
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": 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.

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
            keyword string keyword received in a POST array
keyword is returned with decoded %## (plus symbol ‘+’ will be decoded to a space character)
            type string search engine type in a POST array
            se_domain string search engine domain in a POST array
            location_code integer location code in a POST array
            language_code string language code 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
            sub_title string subtitle of the ‘reviews’ element in SERP
additional information (e.g., address) on the ‘reviews’ element for which the reviews are collected
            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
            feature_id string the unique identifier of the ‘reviews’ element in SERP
learn more about the identifier in this help center article
            place_id string unique identifier of a business location assigned by Google
learn more about the identifier in this help center article
            cid string google-defined client id
unique id of a local establishment
learn more about the identifier in this help center article
            reviews_count integer the total number of reviews
            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: "google_reviews_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
                xpath string the XPath of the review
                review_text string the content of the review
                original_review_text string original content of the review
the original content of the review, no auto-translate applied
                time_ago string the time of publication
indicates the time (in the ‘time ago’ format) when the review was listed
                timestamp string date and time when a review was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                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
indicated the number of votes the review obtained
                  rating_max integer the maximum value for a rating_type
the maximum value for Max5 is 5
                reviews_count integer total number of reviews submitted by the reviewer
                photos_count integer total number of photos submitted by the reviewer
                local_guide boolean indicates whether the reviewer has a ‘local guide’ status
                profile_name string profile name of the reviewer
                profile_url string URL of the reviewer’s profile
                profile_image_url string URL of the reviewer’s profile image
                owner_answer string text of the owner’s response
the owner’s response to the review
                original_owner_answer string original text of the owner’s response
the original response to the review, no auto-translate applied
                owner_time_ago string publication time
indicates the time (in the ‘time ago’ format) when the owner submitted the response to the review
                owner_timestamp string date and time of the owner’s reply to the review
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00

‌‌