Felo API PlatformFelo API Platform

Data API / DataForSEO / Business Data

Get Business Data Tripadvisor Search Results by id

Retrieves queued Tripadvisor properties matching a query - how to find the id the reviews endpoint needs 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.

Parameters

path

  • idstringRequired

    DataForSEO task ID.

Example request

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/search/task_get/{id}" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

  • versionstringOptional

    the current version of the API

  • status_codeintegerOptional

    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_messagestringOptional

    general informational message you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    *total tasks cost, USD*

  • tasks_countintegerOptional

    *the number of tasks in the tasks array*

  • tasks_errorintegerOptional

    *the number of tasks in the tasks array that were returned an error*

  • tasksstring[]Optional

    array of tasks

  • idstringOptional

    task identifier unique task identifier in our system in the UUID format

  • status_codeintegerOptional

    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_messagestringOptional

    informational message of the task you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    cost of the task, USD

  • result_countintegerOptional

    number of elements in the result array

  • pathstring[]Optional

    URL path

  • dataobjectOptional

    contains the same parameters that you specified in the POST request

  • resultstring[]Optional

    array of results

  • keywordstringOptional

    keyword received in a POST array this field will contain the alias parameter if it was specified in a POST array

  • se_domainstringOptional

    search engine domain in a POST array

  • location_codestringOptional

    location code in a POST array

  • language_codestringOptional

    language code in a POST array

  • check_urlstringOptional

    direct URL to Tripadvisor results you can use it to make sure that we provided accurate results

  • datetimestringOptional

    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

  • item_typesstring[]Optional

    item types encountered in the result possible item types: tripadvisor_search_organic

  • se_results_countintegerOptional

    the total number of results

  • items_countintegerOptional

    the number of items in the results array you can get more results by using the depth parameter when setting a task

  • itemsstring[]Optional

    Tripadvisor search listing results you can get more results by using the depth parameter when setting a task

  • typestringOptional

    type of Tripadvisor search result possible types: tripadvisor_search_organic

  • rank_groupintegerOptional

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

  • rank_absoluteintegerOptional

    absolute rank among all the listed results absolute position among all reviews on the list

  • titlestringOptional

    name of the business entity

  • url_pathstringOptional

    URL path of the business entity URL path to the Tripadvisor page of the business entity you can use this identifier to collect reviews for the business entity using Tripadvisor Reviews

  • is_sponsoredbooleanOptional

    indicates a sponsored placement if true, related tripadvisor_search_organic item is a paid advertising on Tripadvisor

  • reviews_countintegerOptional

    the total number of reviews

  • categorystringOptional

    place category

  • price_ratestringOptional

    average price rate

  • ratingobjectOptional

    the rating score of the establishment submitted by the reviewers

  • rating_typestringOptional

    the type of the rating can take the following values: Max5

  • valuenumberOptional

    the value of the rating

  • votes_countintegerOptional

    the amount of feedback indicates the number of votes the establishment obtained

  • rating_maxintegerOptional

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