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.

Параметры

путь

  • idstringОбязательный

    DataForSEO task ID.

Пример запроса

curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/tripadvisor/search/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

  • keywordstringНеобязательный

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

  • se_domainstringНеобязательный

    search engine domain in a POST array

  • location_codestringНеобязательный

    location code in a POST array

  • language_codestringНеобязательный

    language code in a POST array

  • check_urlstringНеобязательный

    direct URL to Tripadvisor 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

  • item_typesstring[]Необязательный

    item types encountered in the result possible item types: tripadvisor_search_organic

  • se_results_countintegerНеобязательный

    the total number of results

  • 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[]Необязательный

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

  • typestringНеобязательный

    type of Tripadvisor search result possible types: tripadvisor_search_organic

  • 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 results absolute position among all reviews on the list

  • titlestringНеобязательный

    name of the business entity

  • url_pathstringНеобязательный

    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_sponsoredbooleanНеобязательный

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

  • reviews_countintegerНеобязательный

    the total number of reviews

  • categorystringНеобязательный

    place category

  • price_ratestringНеобязательный

    average price rate

  • ratingobjectНеобязательный

    the rating score of the establishment submitted by the reviewers

  • 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 indicates the number of votes the establishment obtained

  • rating_maxintegerНеобязательный

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