Felo API PlatformFelo API Platform

데이터 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 tasks array*

  • tasks_errorinteger선택

    *the number of tasks in the tasks array 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 result array

  • pathstring[]선택

    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:00

  • titlestring선택

    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, CustomMax

  • valuenumber선택

    the average rating based on all reviews

  • votes_countinteger선택

    the number of votes

  • rating_maxinteger선택

    the maximum value for a rating_type

  • rating_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 depth parameter when setting a task

  • itemsstring[]선택

    found reviews you can get more results by using the depth parameter when setting a task

  • typestring선택

    the review’s type possible review types: "tripadvisor_review_search"

  • rank_groupinteger선택

    position within a group of elements with identical type values positions of elements with different type values are omitted from rank_group

  • rank_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: right

  • urlstring선택

    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: Max5

  • valuenumber선택

    the value of the rating

  • votes_countinteger선택

    the amount of feedback in this case, the value will be null

  • rating_maxinteger선택

    the maximum value for a rating_type the maximum value for Max5 is 5

  • date_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:00

  • timestampstring선택

    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:00

  • review_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