데이터 API / DataForSEO / Business 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.
파라미터
경로
idstring필수DataForSEO task ID.
요청 예시
curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/extended_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:
Max5,CustomMaxvaluenumber선택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
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
sourceobject선택source of the review contains information about the source where the review was posted
titlestring선택name of the source where the review was posted
imagestring선택featured image of the source
domainstring선택domain of the source where the review was posted