Data 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