資料 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