데이터 API / DataForSEO / Business Data
Get Business Data Tripadvisor Reviews Results by id
Retrieves queued Tripadvisor reviews for one property 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/tripadvisor/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
url_pathstring선택URL path received in a POST array
typestring선택search engine type in a POST array
se_domainstring선택search engine domain 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
locationstring선택location of the local establishment address of the local establishment for which the reviews are collected
reviews_countinteger선택the total number of reviews
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_typerating_distributionobject선택rating distribution by votes the distribution of votes across the rating in the range from 1 to 5
1integer선택votes for the 1-point rating
2integer선택votes for the 2-points rating
3integer선택votes for the 3-points rating
4integer선택votes for the 4-points rating
5integer선택votes for the 5-points rating
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선택the review’s type possible review types:
"tripadvisor_review_search"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:
righturlstring선택URL of the reviewer’s profile
ratingobject선택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 in this case, the value will be
nullrating_maxinteger선택the maximum value for a
rating_typethe maximum value forMax5is 5date_of_visitstring선택date of the reviewer’s visit to the local establishment in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example:
2019-11-15 12:57:46 +00:00timestampstring선택date and time when the response was published in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example:
2019-11-15 12:57:46 +00:00review_idstring선택ID of the review
titlestring선택title of the owner’s response indicates the owner’s name
review_textstring선택content of the review
languagestring선택language of the response text
original_languagestring선택language of the untranslated review text
review_imagesstring[]선택contains URLs of the images used in the review
user_profileobject선택information from the reviewer’s profile
namestring선택reviewer’s profile name
image_urlstring선택URL of the reviewer’s profile image
locationstring선택URL of the reviewer’s profile image
reviews_countstring선택total number of reviews submitted by the reviewer
responsesstring[]선택contains information about the owner’s response
textstring선택text of the owner’s response
response_idstring선택ID of the response
review_highlightsstring[]선택review highlights contains highlighted review criteria and assessments
featurestring선택reviewed feature
assessmentstring선택feature assessment