Get Business Data Google Reviews Results by id

curl --request GET \
  --url https://api.aisa.one/apis/v1/dataforseo/business_data/google/reviews/task_get/{id} \
  --header 'Authorization: Bearer <token>'

{
  "version": "<string>",
  "version.status_code": 123,
  "version.status_message": "<string>",
  "version.time": "<string>",
  "version.cost": 123,
  "version.tasks_count": 123,
  "version.tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "result": [
    "<string>"
  ],
  "result.keyword": "<string>",
  "result.type": "<string>",
  "result.se_domain": "<string>",
  "result.location_code": 123,
  "result.language_code": "<string>",
  "result.check_url": "<string>",
  "result.datetime": "<string>",
  "result.title": "<string>",
  "result.sub_title": "<string>",
  "result.rating": {},
  "result.rating_type": "<string>",
  "result.value": 123,
  "result.votes_count": 123,
  "result.rating_max": 123,
  "result.feature_id": "<string>",
  "result.place_id": "<string>",
  "result.cid": "<string>",
  "result.reviews_count": 123,
  "result.items_count": 123,
  "items": [
    "<string>"
  ],
  "items.type": "<string>",
  "items.rank_group": 123,
  "items.rank_absolute": 123,
  "items.position": "<string>",
  "items.xpath": "<string>",
  "items.review_text": "<string>",
  "items.original_review_text": "<string>",
  "items.time_ago": "<string>",
  "items.timestamp": "<string>",
  "items.rating": {},
  "items.rating_type": "<string>",
  "items.value": 123,
  "items.votes_count": 123,
  "items.rating_max": 123,
  "items.reviews_count": 123,
  "items.photos_count": 123,
  "items.local_guide": true,
  "items.profile_name": "<string>",
  "items.profile_url": "<string>",
  "items.review_url": "<string>",
  "items.profile_image_url": "<string>",
  "items.owner_answer": "<string>",
  "items.original_owner_answer": "<string>",
  "items.owner_time_ago": "<string>",
  "items.owner_timestamp": "<string>",
  "items.review_id": "<string>",
  "items.images": [
    "<string>"
  ],
  "items.alt": "<string>",
  "items.url": "<string>",
  "items.image_url": "<string>",
  "items.review_highlights": [
    "<string>"
  ],
  "items.feature": "<string>",
  "items.assessment": "<string>"
}

GET

https://api.aisa.one/apis/v1

dataforseo

business_data

google

reviews

task_get

{id}

Get Business Data Google Reviews Results by id

curl --request GET \
  --url https://api.aisa.one/apis/v1/dataforseo/business_data/google/reviews/task_get/{id} \
  --header 'Authorization: Bearer <token>'

{
  "version": "<string>",
  "version.status_code": 123,
  "version.status_message": "<string>",
  "version.time": "<string>",
  "version.cost": 123,
  "version.tasks_count": 123,
  "version.tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "result": [
    "<string>"
  ],
  "result.keyword": "<string>",
  "result.type": "<string>",
  "result.se_domain": "<string>",
  "result.location_code": 123,
  "result.language_code": "<string>",
  "result.check_url": "<string>",
  "result.datetime": "<string>",
  "result.title": "<string>",
  "result.sub_title": "<string>",
  "result.rating": {},
  "result.rating_type": "<string>",
  "result.value": 123,
  "result.votes_count": 123,
  "result.rating_max": 123,
  "result.feature_id": "<string>",
  "result.place_id": "<string>",
  "result.cid": "<string>",
  "result.reviews_count": 123,
  "result.items_count": 123,
  "items": [
    "<string>"
  ],
  "items.type": "<string>",
  "items.rank_group": 123,
  "items.rank_absolute": 123,
  "items.position": "<string>",
  "items.xpath": "<string>",
  "items.review_text": "<string>",
  "items.original_review_text": "<string>",
  "items.time_ago": "<string>",
  "items.timestamp": "<string>",
  "items.rating": {},
  "items.rating_type": "<string>",
  "items.value": 123,
  "items.votes_count": 123,
  "items.rating_max": 123,
  "items.reviews_count": 123,
  "items.photos_count": 123,
  "items.local_guide": true,
  "items.profile_name": "<string>",
  "items.profile_url": "<string>",
  "items.review_url": "<string>",
  "items.profile_image_url": "<string>",
  "items.owner_answer": "<string>",
  "items.original_owner_answer": "<string>",
  "items.owner_time_ago": "<string>",
  "items.owner_timestamp": "<string>",
  "items.review_id": "<string>",
  "items.images": [
    "<string>"
  ],
  "items.alt": "<string>",
  "items.url": "<string>",
  "items.image_url": "<string>",
  "items.review_highlights": [
    "<string>"
  ],
  "items.feature": "<string>",
  "items.assessment": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

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

Response

Successful response

version

string

the current version of the API

version.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

version.status_message

string

general informational message you can find the full list of general informational messages here

version.time

string

execution time, seconds

version.cost

number

total tasks cost, USD

version.tasks_count

integer

the number of tasks in the tasks array

version.tasks_error

integer

the number of tasks in the tasks array that were returned an error

tasks

string[]

array of tasks

tasks.id

string

task identifier unique task identifier in our system in the UUID format

tasks.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

tasks.status_message

string

informational message of the task you can find the full list of general informational messages here

tasks.time

string

execution time, seconds

tasks.cost

number

cost of the task, USD

tasks.result_count

integer

number of elements in the result array

tasks.path

string[]

URL path

tasks.data

object

contains the same parameters that you specified in the POST request

result

string[]

array of results

result.keyword

string

keyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)

result.type

string

search engine type in a POST array

result.se_domain

string

search engine domain in a POST array

result.location_code

integer

location code in a POST array

result.language_code

string

language code in a POST array

result.check_url

string

direct URL to search engine results you can use it to make sure that we provided accurate results

result.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

result.title

string

title of the ‘reviews’ element in SERP the name of the local establishment for which the reviews are collected

result.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

result.rating

object

rating of the corresponding local establishment popularity rate based on reviews and displayed in SERP

result.rating_type

string

type of rating here you can find the following elements: Max5, Percents, CustomMax

result.value

number

the average rating based on all reviews

result.votes_count

integer

the number of votes

result.rating_max

integer

the maximum value for a rating_type

result.feature_id

string

the unique identifier of the ‘reviews’ element in SERP learn more about the identifier in this help center article

result.place_id

string

unique identifier of a business location assigned by Google learn more about the identifier in this help center article

result.cid

string

google-defined client id unique id of a local establishment learn more about the identifier in this help center article

result.reviews_count

integer

the total number of reviews

result.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

string[]

found reviews you can get more results by using the depth parameter when setting a task

items.type

string

type of element = ‘images_element’

items.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

items.rank_absolute

integer

absolute rank among all the listed reviews absolute position among all reviews on the list

items.position

string

the alignment of the review in SERP can take the following values: right

items.xpath

string

the XPath of the review

items.review_text

string

the content of the review

items.original_review_text

string

original content of the review the original content of the review, no auto-translate applied

items.time_ago

string

the time of publication indicates the time (in the ‘time ago’ format) when the review was listed

items.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

items.rating

object

the rating score submitted by the reviewer

items.rating_type

string

the type of the rating can take the following values: Max5

items.value

number

the value of the rating

items.votes_count

integer

the amount of feedback indicated the number of votes the review obtained

items.rating_max

integer

the maximum value for a rating_type the maximum value for Max5 is 5

items.reviews_count

integer

total number of reviews submitted by the reviewer

items.photos_count

integer

total number of photos submitted by the reviewer

items.local_guide

boolean

indicates whether the reviewer has a ‘local guide’ status

items.profile_name

string

profile name of the reviewer

items.profile_url

string

URL of the reviewer’s profile

items.review_url

string

the URL of the review

items.profile_image_url

string

URL of the reviewer’s profile image

items.owner_answer

string

text of the owner’s response the owner’s response to the review

items.original_owner_answer

string

original text of the owner’s response the original response to the review, no auto-translate applied

items.owner_time_ago

string

publication time indicates the time (in the ‘time ago’ format) when the owner submitted the response to the review

items.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

items.review_id

string

the unique identifier of a review on Google example: ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

items.images

string[]

images submitted by the reviewer

items.alt

string

alt tag of the image

items.url

string

relevant image URL from Google

items.image_url

string

URL of the image featured in the review

items.review_highlights

string[]

review highlights contains highlighted review criteria and assessments

items.feature

string

reviewed feature

items.assessment

string

feature assessment

Setting Google My Business Questions and Answers Tasks Get Google Reviews Completed Tasks

Documentation Index

Authorizations

Query Parameters

Response