Get Business Data Google Extended Reviews Results by id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Get Business Data Google Extended Reviews Results by id
Retrieves queued the full Google review history for a business, past the first page the standard endpoint returns by id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ Size scales with the depth set at submit and cannot be narrowed here.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- checkType: string | null
_url direct URL to search engine results
you can use it to make sure that we provided accurate results - cidType: string | null
- datetimeType: string | null
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 - featureType: string | null
_id - itemsType: array (object | null)[] | null
found reviews
you can get more results by using thedepthparameter when setting a task- imagesType: array (object | null)[] | null
images submitted by the reviewer
- altType: string | null
alt tag of the image
- imageType: string | null
_url URL of the image
the URL leading to the image on the original resource or DataForSEO storage (in case the original source is not available) - typeType: string | null
type of element
- urlType: string | null
relevant URL
- localType: boolean | null
_guide indicates whether the reviewer has a 'local guide' status
- originalType: string | null
_owner _answer original text of the owner's response
the original response to the review, no auto-translate applied - originalType: string | null
_review _text original content of the review
the original content of the review, no auto-translate applied - ownerType: string | null
_answer text of the owner's response
the owner's response to the review - ownerType: string | null
_time _ago publication time
indicates the time (in the 'time ago' format) when the owner submitted the response to the review - ownerType: string | null
_timestamp 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 - photosType: integer | null Format: int64
_count total number of photos submitted by the reviewer
- positionType: string | null
the alignment of the review in SERP
can take the following values:right - profileType: string | null
_image _url URL of the reviewer's profile image
- profileType: string | null
_name profile name of the reviewer
- profileType: string | null
_url URL of the reviewer's profile
- rankType: integer | null
_absolute absolute rank among all the listed reviews
absolute position among all reviews on the list - rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted fromrank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
the rating score submitted by the reviewer
- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- reviewType: array (object | null)[] | null
_highlights review highlights
contains highlighted review criteria and assessments- assessmentType: string | null
feature assessment
- featureType: string | null
reviewed feature
- reviewType: string | null
_id the unique identifier of a review on Google
example:ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE - reviewType: string | null
_text the content of the review
- reviewType: string | null
_url the URL of the review
- reviewsType: integer | null Format: int64
_count total number of reviews submitted by the reviewer
- sourceType: object | null · Response36Afe1097B20_Source
source of the review
contains information about the source where the review was posted- domainType: string | null
domain of the source where the review was posted
- imageType: string | null
featured image of the source
- titleType: string | null
name of the source where the review was posted
- timeType: string | null
_ago the time of publication
indicates the time (in the 'time ago' format) when the review was listed - timestampType: string | null
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 - typeType: string | null
type of element
- xpathType: string | null
- itemsType: integer | null Format: int64
_count the number of reviews items in the results array
you can get more results by using thedepthparameter when setting a task - keywordType: string | null
keyword received in a POST array
keyword is returned with decoded %## (plus character '+' will be decoded to a space character) - languageType: string | null
_code language code in a POST array
- locationType: integer | null
_code location code in a POST array
- placeType: string | null
_id - ratingType: object | null · Response36Afe1097B20_RatingInfo
rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- reviewsType: integer | null Format: int64
_count the total number of reviews
- seType: string | null
_domain search engine domain in a POST array
- subType: string | null
_title subtitle of the 'reviews' element in SERP
additional information (e.g., address) on the 'reviews' element for which the reviews are collected - titleType: string | null
title of the 'reviews' element in SERP
the name of the local establishment for which the reviews are collected - typeType: string | null
type of element
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code 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
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_reviews/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"title": null,
"sub_title": null,
"rating": {
"rating_type": null,
"value": null,
"votes_count": null,
"rating_max": null
},
"feature_id": null,
"place_id": null,
"cid": null,
"reviews_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"review_text": null,
"original_review_text": null,
"time_ago": null,
"timestamp": null,
"rating": "[Max Depth Exceeded]",
"reviews_count": null,
"photos_count": null,
"local_guide": null,
"profile_name": null,
"profile_url": null,
"review_url": null,
"profile_image_url": null,
"owner_answer": null,
"original_owner_answer": null,
"owner_time_ago": null,
"owner_timestamp": null,
"review_id": null,
"images": [
"[Max Depth Exceeded]"
],
"review_highlights": [
"[Max Depth Exceeded]"
],
"source": "[Max Depth Exceeded]"
}
]
}
]
}
]
}