Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия TripAdvisor: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите отели, рестораны и достопримечательности на TripAdvisor по ключевому слову: категория, рейтинг, число отзывов, место в городе, ценовая категория и адрес. | $1.39 за 1 000 запросов | Норма |
Сведенияprofile | Получите страницу TripAdvisor об одном отеле, ресторане или достопримечательности: рейтинг, число отзывов, место в городе, ценовую категорию, адрес, координаты и контакты. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Получите отзывы путешественников об отеле, ресторане или достопримечательности на TripAdvisor: оценку, тип и дату поездки, данные автора и ответы владельца. | $1.39 за 1 000 запросов | Норма |
Restaurantsrestaurants | Находите рестораны на TripAdvisor по ключевому слову: кухни, рейтинг, число отзывов, место в городе, ценовая категория и контакты. | $1.39 за 1 000 запросов | Норма |
Attractionsattractions | Просматривайте достопримечательности TripAdvisor по городу или названию объекта: категория, рейтинг, число отзывов, место среди местных достопримечательностей и адрес. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API TripAdvisor?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите отели, рестораны и достопримечательности на TripAdvisor по ключевому слову: категория, рейтинг, число отзывов, место в городе, ценовая категория и адрес. Чтобы различить места с одинаковым названием, добавьте название города. | keyword | content_type, currency, lang | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
profileСведения Получите страницу TripAdvisor об одном отеле, ресторане или достопримечательности: рейтинг, число отзывов, место в городе, ценовую категорию, адрес, координаты и контакты. Передайте страницу самого места, а не городского каталога. Цены и наличие мест на конкретную дату не охватываются. | url | content_type, currency, lang | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
reviewsОтзывы Получите отзывы путешественников об отеле, ресторане или достопримечательности на TripAdvisor: оценку, тип и дату поездки, данные автора и ответы владельца. Оценивайте актуальность по | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · rating · rating_scale · like_count · author_name · author_username · author_location · author_contributions · trip_type · trip_date · posted_at · language · platform · owner_response · image_urls |
restaurantsRestaurants Находите рестораны на TripAdvisor по ключевому слову: кухни, рейтинг, число отзывов, место в городе, ценовая категория и контакты. Наличие свободных столиков, меню и текущие часы работы не подтверждаются. | keyword | content_type, currency, lang | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
attractionsAttractions Просматривайте достопримечательности TripAdvisor по городу или названию объекта: категория, рейтинг, число отзывов, место среди местных достопримечательностей и адрес. Билеты не продаются, часы работы и доступность для людей с ограниченными возможностями не гарантируются. | keyword | content_type, currency, lang | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · category · url · text · rating · rating_scale · review_count · price_level · ranking · address · city · country · location · phone · email · website · latitude · longitude · image_url · platform · cuisines |
Что означают параметры действия search в API TripAdvisor?
Находите отели, рестораны и достопримечательности на TripAdvisor по ключевому слову: категория, рейтинг, число отзывов, место в городе, ценовая категория и адрес. Чтобы различить места с одинаковым названием, добавьте название города. price_level обозначает категорию в знаках доллара, а не сумму.
keywordОбязательный- Поисковый запрос для поиска мест. Действие
searchищет среди отелей, ресторанов и достопримечательностей, аrestaurantsиattractionsищут только в своей категории. Название города в запросе помогает различить заведения с одинаковыми названиями. Полнотекстовый поиск по отзывам не выполняется. content_typeНеобязательный- Фильтрует фото места по источнику. Допустимые значения:
from_everyone(все фото),from_management(загружены владельцем) иfrom_travelers(загружены посетителями). Не фильтрует категории мест, такие как отели, рестораны или достопримечательности: для нужного типа мест выберите соответствующее действие.Допустимые значения:from_everyonefrom_managementfrom_travelers currencyНеобязательный- Код валюты для отображаемых цен; по умолчанию
usd(часто используются такжеeur,gbpиcny). Полный список значений схемы сохранён, но для поддерживаемых устаревших кодов актуальные цены могут не возвращаться. Параметр не меняет валюту оплаты API.Допустимые значения:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl langНеобязательный- Двухбуквенный код языка (например,
enилиzh) для search, profile, restaurants и attractions. Действие reviews этот параметр не принимает.Допустимые значения:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
Что означают параметры действия profile в API TripAdvisor?
Получите страницу TripAdvisor об одном отеле, ресторане или достопримечательности: рейтинг, число отзывов, место в городе, ценовую категорию, адрес, координаты и контакты. Передайте страницу самого места, а не городского каталога. Цены и наличие мест на конкретную дату не охватываются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- URL заведения TripAdvisor для действий
profileиreviews: прямая ссылка на страницу отеля, ресторана или достопримечательности, а не на каталог города. Вprofileвозвращает данные заведения, а не профиль пользователя.Tripadvisor: рейтинг популярности и оценки — Tripadvisor формирует Popularity Ranking с учётом качества, давности и количества отзывов, а также стабильности результатов во времени; на позицию влияют показатели других заведений в том же регионе, поэтому это не просто другая форма средней оценки. · Проверено content_typeНеобязательный- Фильтрует фото места по источнику. Допустимые значения:
from_everyone(все фото),from_management(загружены владельцем) иfrom_travelers(загружены посетителями). Не фильтрует категории мест, такие как отели, рестораны или достопримечательности: для нужного типа мест выберите соответствующее действие.Допустимые значения:from_everyonefrom_managementfrom_travelers currencyНеобязательный- Код валюты для отображаемых цен; по умолчанию
usd(часто используются такжеeur,gbpиcny). Полный список значений схемы сохранён, но для поддерживаемых устаревших кодов актуальные цены могут не возвращаться. Параметр не меняет валюту оплаты API.Допустимые значения:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl langНеобязательный- Двухбуквенный код языка (например,
enилиzh) для search, profile, restaurants и attractions. Действие reviews этот параметр не принимает.Допустимые значения:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
Что означают параметры действия reviews в API TripAdvisor?
Получите отзывы путешественников об отеле, ресторане или достопримечательности на TripAdvisor: оценку, тип и дату поездки, данные автора и ответы владельца. Оценивайте актуальность по trip_date, а не по posted_at, и не рассчитывайте получить все отзывы о месте.
urlОбязательный- URL заведения TripAdvisor для действий
profileиreviews: прямая ссылка на страницу отеля, ресторана или достопримечательности, а не на каталог города. Вprofileвозвращает данные заведения, а не профиль пользователя.
Что означают параметры действия restaurants в API TripAdvisor?
Находите рестораны на TripAdvisor по ключевому слову: кухни, рейтинг, число отзывов, место в городе, ценовая категория и контакты. Наличие свободных столиков, меню и текущие часы работы не подтверждаются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для поиска мест. Действие
searchищет среди отелей, ресторанов и достопримечательностей, аrestaurantsиattractionsищут только в своей категории. Название города в запросе помогает различить заведения с одинаковыми названиями. Полнотекстовый поиск по отзывам не выполняется. content_typeНеобязательный- Фильтрует фото места по источнику. Допустимые значения:
from_everyone(все фото),from_management(загружены владельцем) иfrom_travelers(загружены посетителями). Не фильтрует категории мест, такие как отели, рестораны или достопримечательности: для нужного типа мест выберите соответствующее действие.Допустимые значения:from_everyonefrom_managementfrom_travelers currencyНеобязательный- Код валюты для отображаемых цен; по умолчанию
usd(часто используются такжеeur,gbpиcny). Полный список значений схемы сохранён, но для поддерживаемых устаревших кодов актуальные цены могут не возвращаться. Параметр не меняет валюту оплаты API.Допустимые значения:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl langНеобязательный- Двухбуквенный код языка (например,
enилиzh) для search, profile, restaurants и attractions. Действие reviews этот параметр не принимает.Допустимые значения:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
Что означают параметры действия attractions в API TripAdvisor?
Просматривайте достопримечательности TripAdvisor по городу или названию объекта: категория, рейтинг, число отзывов, место среди местных достопримечательностей и адрес. Билеты не продаются, часы работы и доступность для людей с ограниченными возможностями не гарантируются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для поиска мест. Действие
searchищет среди отелей, ресторанов и достопримечательностей, аrestaurantsиattractionsищут только в своей категории. Название города в запросе помогает различить заведения с одинаковыми названиями. Полнотекстовый поиск по отзывам не выполняется. content_typeНеобязательный- Фильтрует фото места по источнику. Допустимые значения:
from_everyone(все фото),from_management(загружены владельцем) иfrom_travelers(загружены посетителями). Не фильтрует категории мест, такие как отели, рестораны или достопримечательности: для нужного типа мест выберите соответствующее действие.Допустимые значения:from_everyonefrom_managementfrom_travelers currencyНеобязательный- Код валюты для отображаемых цен; по умолчанию
usd(часто используются такжеeur,gbpиcny). Полный список значений схемы сохранён, но для поддерживаемых устаревших кодов актуальные цены могут не возвращаться. Параметр не меняет валюту оплаты API.Допустимые значения:aedafnallamdarsaudaznbambdtbgnbhdbifbndbobbrlbwpbynbzdcadcdfchfclpcnycopcrccveczkdjfdkkdopdzdeekegpernetbeurgbpgelghsgnfgtqhkdhnlhrkhufidrilsinriqdirriskjmdjodjpykeskhrkmfkrwkwdkztlbplkrltllvllydmadmdlmgamkdmmkmopmurmxnmyrmznnadngnnionoknprnzdomrpabpenphppkrplnpygqarronrsdrubrwfsarsdgseksgdsossypthbtndtoptryttdtwdtzsuahugxusduyuuzsvefvndxafxofyerzarzmkzwl langНеобязательный- Двухбуквенный код языка (например,
enилиzh) для search, profile, restaurants и attractions. Действие reviews этот параметр не принимает.Допустимые значения:aaabaeafakamanarasavayazbabebgbhbibmbnbobrbscacechcocrcscucvcydadedveeeleneoeseteufafffifjfofrfygagdglgngugvhahehihohrhthuhyhziaidieigiiikioisitiuiwjajvkakgkikjkkklkmknkokrkskukvkwkylalblglilnloltlulvmgmhmimkmlmnmrmsmtmynanbndnengnlnnnonrnvnyocojomorospapiplpsptqurmrnrorurwsascsdsesgsiskslsmsnsosqsrssstsusvswtatetgthtitktltntotrtstttwtyugukuruzvevivowawoxhyiyozazh
Как использовать API TripAdvisor
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"tripadvisor","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API TripAdvisor
Какие данные можно получить через API TripAdvisor?
Укажите в platform значение tripadvisor. В текущем каталоге: поиск, сведения, отзывы, restaurants и attractions. Эти названия действий соответствуют разным объектам или представлениям TripAdvisor; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе TripAdvisor?
Поисковый запрос для поиска мест. Действие search ищет среди отелей, ресторанов и достопримечательностей, а restaurants и attractions ищут только в своей категории. Название города в запросе помогает различить заведения с одинаковыми названиями. Полнотекстовый поиск по отзывам не выполняется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе TripAdvisor?
Объявленная схема включает name, category, text и rating. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия TripAdvisor возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.