Felo API PlatformFelo API Platform

数据 API / DataForSEO / Business Data

Get Business Data Trustpilot Reviews Results by id

Retrieves queued Trustpilot reviews for one business 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/trustpilot/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

  • domainstring可选

    domain of the business entity

  • 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 on Trustpilot the name of the business entity for which the reviews are collected

  • locationstring可选

    location of the business entity as specified on Trustpilot address of the business entity for which the reviews are collected

  • reviews_countinteger可选

    the total number of reviews

  • ratingobject可选

    rating of the corresponding business entity 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

  • items_countinteger可选

    the number of 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: "trustpilot_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 to 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 indicated the number of votes the review obtained

  • rating_maxinteger可选

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

  • verifiedboolean可选

    indicates whether the review has the “Verified” mark

  • languageboolean可选

    the language of the review

  • 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

  • titlestring可选

    title of the owner’s response

  • review_textstring可选

    the content of the review

  • review_imagesstring[]可选

    images submitted by the reviewer displays URLs to the images provided by the author of the review; please note that Trustpilot doesn’t allow adding images to reviews, so the review_images parameter will always equal null

  • user_profileobject可选

    user profile of the reviewer

  • namestring可选

    the name of the reviewer

  • image_urlstring可选

    URL to the reviewer’s profile picture

  • locationstring可选

    country of the reviewer

  • reviews_countinteger可选

    total number of reviews submitted by the reviewer

  • responsesstring[]可选

    owner’s response to the submitted review

  • textstring可选

    text of the owner’s response