Data API / DataForSEO / Business Data
Get Business Data Google Reviews Results by id
Retrieves queued Google Business Profile reviews 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.
Параметры
путь
idstringОбязательныйDataForSEO task ID.
Пример запроса
curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/reviews/task_get/{id}" \
-H "Authorization: Bearer $FELO_API_KEY"Ответ
Поля ответа
versionstringНеобязательныйthe current version of the API
status_codeintegerНеобязательный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_messagestringНеобязательныйgeneral informational message you can find the full list of general informational messages here
timestringНеобязательныйexecution time, seconds
costnumberНеобязательный*total tasks cost, USD*
tasks_countintegerНеобязательный*the number of tasks in the
tasksarray*tasks_errorintegerНеобязательный*the number of tasks in the
tasksarray that were returned an error*tasksstring[]Необязательныйarray of tasks
idstringНеобязательныйtask identifier unique task identifier in our system in the UUID format
status_codeintegerНеобязательный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_messagestringНеобязательныйinformational message of the task you can find the full list of general informational messages here
timestringНеобязательныйexecution time, seconds
costnumberНеобязательныйcost of the task, USD
result_countintegerНеобязательныйnumber of elements in the
resultarraypathstring[]НеобязательныйURL path
dataobjectНеобязательныйcontains the same parameters that you specified in the POST request
resultstring[]Необязательныйarray of results
keywordstringНеобязательныйkeyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)
typestringНеобязательныйsearch engine type in a POST array
se_domainstringНеобязательныйsearch engine domain in a POST array
location_codeintegerНеобязательныйlocation code in a POST array
language_codestringНеобязательныйlanguage code in a POST array
check_urlstringНеобязательныйdirect URL to search engine results you can use it to make sure that we provided accurate results
datetimestringНеобязательный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:00titlestringНеобязательныйtitle of the ‘reviews’ element in SERP the name of the local establishment for which the reviews are collected
sub_titlestringНеобязательныйsubtitle of the ‘reviews’ element in SERP additional information (e.g., address) on the ‘reviews’ element for which the reviews are collected
ratingobjectНеобязательныйrating of the corresponding local establishment popularity rate based on reviews and displayed in SERP
rating_typestringНеобязательныйtype of rating here you can find the following elements:
Max5,Percents,CustomMaxvaluenumberНеобязательныйthe average rating based on all reviews
votes_countintegerНеобязательныйthe number of votes
rating_maxintegerНеобязательныйthe maximum value for a
rating_typefeature_idstringНеобязательныйthe unique identifier of the ‘reviews’ element in SERP learn more about the identifier in this help center article
place_idstringНеобязательныйunique identifier of a business location assigned by Google learn more about the identifier in this help center article
cidstringНеобязательныйgoogle-defined client id unique id of a local establishment learn more about the identifier in this help center article
reviews_countintegerНеобязательныйthe total number of reviews
items_countintegerНеобязательныйthe number of reviews items in the results array you can get more results by using the
depthparameter when setting a taskitemsstring[]Необязательныйfound reviews you can get more results by using the
depthparameter when setting a tasktypestringНеобязательный*type of element = ‘images\_element’*
rank_groupintegerНеобязательныйposition within a group of elements with identical
typevalues positions of elements with differenttypevalues are omitted fromrank_grouprank_absoluteintegerНеобязательныйabsolute rank among all the listed reviews absolute position among all reviews on the list
positionstringНеобязательныйthe alignment of the review in SERP can take the following values:
rightxpathstringНеобязательныйthe XPath of the review
review_textstringНеобязательныйthe content of the review
original_review_textstringНеобязательныйoriginal content of the review the original content of the review, no auto-translate applied
time_agostringНеобязательныйthe time of publication indicates the time (in the ‘time ago’ format) when the review was listed
timestampstringНеобязательный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:00ratingobjectНеобязательныйthe rating score submitted by the reviewer
rating_typestringНеобязательныйthe type of the rating can take the following values:
Max5valuenumberНеобязательныйthe value of the rating
votes_countintegerНеобязательныйthe amount of feedback indicated the number of votes the review obtained
rating_maxintegerНеобязательныйthe maximum value for a
rating_typethe maximum value forMax5is 5reviews_countintegerНеобязательныйtotal number of reviews submitted by the reviewer
photos_countintegerНеобязательныйtotal number of photos submitted by the reviewer
local_guidebooleanНеобязательныйindicates whether the reviewer has a ‘local guide’ status
profile_namestringНеобязательныйprofile name of the reviewer
profile_urlstringНеобязательныйURL of the reviewer’s profile
review_urlstringНеобязательныйthe URL of the review
profile_image_urlstringНеобязательныйURL of the reviewer’s profile image
owner_answerstringНеобязательныйtext of the owner’s response the owner’s response to the review
original_owner_answerstringНеобязательныйoriginal text of the owner’s response the original response to the review, no auto-translate applied
owner_time_agostringНеобязательныйpublication time indicates the time (in the ‘time ago’ format) when the owner submitted the response to the review
owner_timestampstringНеобязательный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:00review_idstringНеобязательныйthe unique identifier of a review on Google example:
ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAEimagesstring[]Необязательныйimages submitted by the reviewer
altstringНеобязательныйalt tag of the image
urlstringНеобязательныйrelevant image URL from Google
image_urlstringНеобязательныйURL of the image featured in the review
review_highlightsstring[]Необязательныйreview highlights contains highlighted review criteria and assessments
featurestringНеобязательныйreviewed feature
assessmentstringНеобязательныйfeature assessment