Get Business Data Tripadvisor Reviews Results by id
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility 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.
Pricing reference
- Metering: Reported response cost.
- Reference request estimate: USD 0.012.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetResponseInfo200
- Type: number | null Format: doublecost
total tasks cost, USD
- Type: integer | nullstatus
_code general status code you can find the full list of the response codes here
- Type: string | nullstatus
_message general informational message you can find the full list of general informational messages here
- Type: array (object | null)[] | nulltasks
array of tasks
- Type: object | null · Response36Afe1097B20_BusinessDataTripadvisorReviewsTaskGetTaskInfo
- costType: number | null Format: double
total tasks cost, USD
- dataType: object | null
contains the same parameters that you specified in the POST request
- propertyType: object | null
Name
- idType: string | null
task identifier unique task identifier in our system in the UUID format
- pathType: array (string | null)[] | null
URL path
- resultType: array (object | null)[] | null
array of results
- checkType: string | null
_url direct URL to search engine results
you can use it to make sure that we provided accurate results - datetimeType: string | null
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:00 - itemsType: array (object | null)[] | null
found reviews
you can get more results by using thedepthparameter when setting a task- dateType: string | null
_of _visit 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:00 - languageType: string | null
language of the review text
- originalType: string | null
_language language of the untranslated review text
- positionType: string | null
the alignment of the review in SERP
can take the following values:right - rankType: integer | null
_absolute absolute rank among all the listed reviews
absolute position among all reviews on the list - rankType: integer | null
_group position within a group of elements with identical
typevalues
positions of elements with differenttypevalues are omitted fromrank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
the rating score submitted by the reviewer
- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- responsesType: array (object | null)[] | null
contains information about the owner's response
- textType: string | null
the content of response
- timestampType: string | null
the time of publication
- titleType: string | null
the title of response
- reviewType: object | null
_highlights review highlights
contains highlighted review criteria and assessments - reviewType: string | null
_id ID of the review
- reviewType: array (object | null)[] | null
_images contains URLs of the images used in the review
- urlType: string | null
URL of the image used in the review
- reviewType: string | null
_text content of the review
- timestampType: string | null
date and time when the review was published
in the UTC format: "yyyy-mm-dd hh-mm-ss +00:00"
example:2019-11-15 12:57:46 +00:00 - titleType: string | null
title of the review
- typeType: string | null
type of element
- urlType: string | null
URL of the review
- userType: object | null · Response36Afe1097B20_BusinessDataUserProfileInfo
_profile information from the reviewer's profile
- imageType: string | null
_url - locationType: string | null
- nameType: string | null
- reviewsType: integer | null Format: int64
_count total number of reviews submitted by the reviewer
- urlType: string | null
- itemsType: integer | null Format: int64
_count the number of reviews items in the results array
you can get more results by using thedepthparameter when setting a task - languageType: string | null
_code language code in a POST array
- locationType: string | null
location of the local establishment
address of the local establishment for which the reviews are collected - ratingType: object | null · Response36Afe1097B20_RatingInfo
rating of the corresponding local establishment
popularity rate based on reviews and displayed in SERP- ratingType: integer | null
_max the maximum value for a rating_type
- ratingType: string | null
_type the type of rating here you can find the following elements: Max5, Percents, CustomMax
- valueType: number | null Format: double
the value of the rating
- votesType: integer | null Format: int64
_count the amount of feedback
- ratingType: object | null
_distribution rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5- propertyType: integer | null Format: Int64
Name
- reviewsType: integer | null Format: int64
_count the total number of reviews
- seType: string | null
_domain search engine domain in a POST array
- titleType: string | null
title of the 'reviews' element in SERP
the name of the local establishment for which the reviews are collected - typeType: string | null
type of element
- urlType: string | null
_path URL path received in a POST array
- resultType: integer | null Format: int64
_count number of elements in the result array
- statusType: integer | null
_code 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
- statusType: string | null
_message informational message of the task you can find the full list of general informational messages here
- timeType: string | null
execution time, seconds
- Type: integer | null Format: int64tasks
_count the number of tasks in the tasks array
- Type: integer | null Format: int64tasks
_error the number of tasks in the tasks array returned with an error
- Type: string | nulltime
total execution time, seconds
- Type: string | nullversion
the current version of the API
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/reviews/task_get/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"url_path": null,
"type": null,
"se_domain": null,
"check_url": null,
"datetime": null,
"title": null,
"location": null,
"reviews_count": null,
"rating": {
"rating_type": null,
"value": null,
"votes_count": null,
"rating_max": null
},
"rating_distribution": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"url": null,
"rating": "[Max Depth Exceeded]",
"date_of_visit": null,
"timestamp": null,
"review_id": null,
"title": null,
"review_text": null,
"language": null,
"original_language": null,
"review_images": [
"[Max Depth Exceeded]"
],
"user_profile": "[Max Depth Exceeded]",
"responses": [
"[Max Depth Exceeded]"
],
"review_highlights": null
}
],
"language_code": null
}
]
}
]
}