{"id":5408,"date":"2020-03-27T18:12:32","date_gmt":"2020-03-27T18:12:32","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=5408"},"modified":"2020-06-18T09:04:24","modified_gmt":"2020-06-18T09:04:24","slug":"reviews-google-overview","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/reviews-google-overview\/","title":{"rendered":"reviews\/google\/overview"},"content":{"rendered":"<div class=\"wpb-content-wrapper\"><p>[vc_row][vc_column][vc_column_text]<\/p>\n<h1 id=\"introduction\">Google Reviews: Overview<\/h1>\n    <div class=\"endpoint\">\n        <img decoding=\"async\" class=\"endpoint__icon\" src=\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/checked-circle.svg\" alt=\"checked\">\n\n                    This API is designed to provide you with the Google reviews data            <\/div>\n    \n<h3><span style=\"color: #ff0000;\">This API is the updated version of Google Reviews SERP API v2 endpoint.<\/span><\/h3>\n<p>&nbsp;<br \/>\nThe returned results are specific to the indicated local establishment name, search engine, <a href=\"\/v3\/reviews-google-locations\/\" rel=\"noopener noreferrer\" target=\"_blank\">location<\/a> and <a href=\"\/v3\/reviews-google-languages\/\" rel=\"noopener noreferrer\" target=\"_blank\">language<\/a> 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 <code>check_url<\/code> 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.<\/p>\n<p>Please note that Google returns <strong>4490 results<\/strong> maximum. Use the <code>depth<\/code> field to specify the required number of reviews.<\/p>\n<p>You can indicate the following device types and OS you would like to receive Google Reviews results for when setting a task:<\/p>\n<div style=\"width: 95%; margin-left: auto; margin-right: auto;\">\n<ul>\n<li><strong>Mobile<\/strong>. Available OS types: iOS, Android<\/li>\n<li><strong>Desktop<\/strong>. Available OS types: Windows, macOS<\/li>\n<\/ul>\n<\/div>\n<p>\u200c&nbsp;<\/p>\n<h3>Methods<\/h3>\n<p>&nbsp;<br \/>\nGoogle Reviews API supports only the Standard method of data retrieval. It requires making separate <a href=\"\/v3\/reviews-google-task_post\/\" target=\"_blank\" rel=\"noopener noreferrer\">POST<\/a> and <a href=\"\/v3\/reviews-google-task_get\" target=\"_blank\" rel=\"noopener noreferrer\">GET<\/a> requests. Using this method, you can retrieve the results after our system collects them.<\/p>\n<p>Alternatively, you can specify <code>pingback_url<\/code> or <code>postback_url<\/code> when setting a task, and we will notify you on completion of tasks or send them to you respectively.<\/p>\n<p>If you do not specify <code>pingback_url<\/code> or <code>postback_url<\/code>, you can receive the list of <code>id<\/code> for all completed tasks using the <a href=\"\/v3\/reviews-tasks_ready\/\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>&#8216;Tasks Ready&#8217;<\/strong><\/a> endpoint. It is designed to provide you with the list of completed tasks, which haven&#8217;t been collected yet. Then, you can retrieve the results using the <strong>\u2018Task GET\u2019<\/strong> endpoint.<\/p>\n<p>You can send up to 2000 API calls per minute, with each POST call containing no more than 100 tasks. Contact us if you would like to raise the limit.<br \/>\n&nbsp;<\/p>\n<h3>Priorities and cost<\/h3>\n<p>&nbsp;<br \/>\nThe cost of using Google Reviews API depends on the number of reviews you specify in the <code>depth<\/code> field when setting a task and on the selected priority of task execution. <\/p>\n<p>Your account will be charged for every 10 reviews returned in the <code>items<\/code> array, e.g. if you specify <code>\"depth\":&nbsp;11<\/code>, you will be charged as per 20 reviews. <\/p>\n<p><strong>Note:<\/strong> if the value you specify in the <code>depth<\/code> field doesn&#8217;t reflect the actual number of reviews you get in the <code>items<\/code> array (e.g., you indicated <code>\"depth\":&nbsp;100<\/code>, but there are in fact only 30 reviews for your query on Google), all extra money charged at the time of task setting will be refunded to you immediately. <\/p>\n<p>The Standard method has two different priorities that stand for the relative speed of task execution and have different prices:<\/p>\n<p>1. Normal priority;<br \/>\n2. High priority.<\/p>\n<p>The cost can be calculated on the <a title=\"Pricing\" href=\"https:\/\/dataforseo.com\/pricing\" target=\"_blank\" rel=\"noopener noreferrer\">Pricing<\/a> page. You can check your spending in your <a href=\"https:\/\/app.dataforseo.com\/api-access\" target=\"_blank\" rel=\"noopener noreferrer\">account dashboard<\/a> or by making a separate call to <a href=\"\/v3\/appendix\/user_data\/?php\" target=\"_blank\" rel=\"noopener noreferrer\">the User Data endpoint<\/a><\/p>\n<p>You can test Google Reviews API for free using DataForSEO <a href=\"\/v3\/appendix\/sandbox\/\">Sandbox<\/a>.<br \/>\n[\/vc_column_text][\/vc_column][\/vc_row]<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>[vc_row][vc_column][vc_column_text] Google Reviews: Overview This API is designed to provide you with the Google reviews data This API is the updated version of Google Reviews SERP API v2 endpoint. &nbsp; 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 [&hellip;]<\/p>\n","protected":false},"author":17,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template.php","meta":{"apibase_doc_request_yaml":"","apibase_doc_request_additional_yaml":"","apibase_doc_response_yaml":"","footnotes":""},"class_list":["post-5408","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/5408","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/comments?post=5408"}],"version-history":[{"count":18,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/5408\/revisions"}],"predecessor-version":[{"id":6260,"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/pages\/5408\/revisions\/6260"}],"wp:attachment":[{"href":"https:\/\/docs.dataforseo.com\/v3\/wp-json\/wp\/v2\/media?parent=5408"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}