Сценарий использования

API для сбора отзывов и мониторинга репутации

Собирайте отзывы из Google Maps, Trustpilot, G2, App Store, Google Play, Tripadvisor, Booking.com и Amazon в JSON, новые сначала. Оплата за отзыв.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google MapsTrustpilotG2App StoreTripadvisorlovelyjsonitems[0]"rating": 2"title": "Slow checkout""text": "Waited 20 minutes…""author": "Maria K.""date": "2026-10-18""reply": null

Отзывы о вас разбросаны по Google Maps, Trustpilot, G2, магазинам приложений, Tripadvisor, Booking.com и Amazon. Lovely Router собирает их через один API для сбора отзывов: отправьте место, домен, приложение или товар и получите отзывы в JSON со звёздами, текстом и датами. Вы платите за отзыв, поэтому ежедневная проверка стоит ровно столько, сколько отзывов она вернула. Запускайте сбор из cron-задачи или поручите агенту прочитать отзывы и рассказать, что изменилось.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Collect reviews, newest first, from Google Maps, Trustpilot, G2, the App Store, Google Play, Tripadvisor, Booking.com and Amazon, and summarize what customers say. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the business, app or product, the review sites and the period>
01

Как это работает

010203
  1. Укажите каждому инструменту вашу карточку

    Place ID в Google Maps, домен в Trustpilot, slug продукта в G2, ID в App Store, имя пакета в Google Play, URL страницы на Tripadvisor или Booking.com, ASIN на Amazon.

  2. Заберите свежие отзывы

    Сортируйте по новизне или фильтруйте по оценке и ограничивайте каждый запуск через max_results. Запуск резервирует свою максимальную стоимость и списывает оплату только за возвращённые отзывы.

  3. Действуйте

    Сохраняйте уже просмотренное, присылайте оповещения о новых низких оценках и отправляйте текст модели на том же ключе, чтобы сгруппировать жалобы по темам.

02

Отзывы Google Maps одним запросом

Отзывы Google Maps принимает place ID или URL мест. Этот запуск возвращает 20 самых новых отзывов об одном месте:

curl https://lovelyrouter.com/v1/tools/google-maps-reviews/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4"],
      "maxReviews": 20,
      "reviewsSort": "newest"
    },
    "max_results": 20
  }'

Каждый отзыв в items содержит текст, звёзды, дату и ответ владельца. maxReviews задаётся на одно место, а max_results ограничивает весь запуск, поэтому при нескольких place ID задавайте оба параметра. Запуск, который идёт дольше 60 секунд, возвращает 202; как опрашивать результат, описано в разделе Запуск инструмента.

Для Trustpilot отправляйте домены и фильтруйте по звёздам. Этот запуск возвращает до 50 отзывов с одной и двумя звёздами, новые сначала; укажите свой домен в companyUrls:

cURL
curl https://lovelyrouter.com/v1/tools/trustpilot-reviews/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input": {"companyUrls": ["example.com"], "stars": ["1", "2"], "sort": "recency"}, "max_results": 50}'
03

Инструменты

Google Maps
Отзывы Google Maps

Отзывы о месте в Google Maps (по place ID или URL): текст, звёзды, дата, ответы владельца.

$0.000675 / reviewПодробности →
Trustpilot
Отзывы Trustpilot

Отзывы о компании на Trustpilot по домену: звёзды, текст, дата, ответ.

$0.0015 / review + $0.0075 / callПодробности →
G2
Отзывы о ПО на G2

Отзывы G2 о программном продукте.

$0.0075 / review + $0.015 / callПодробности →
App Store
Отзывы App Store

Отзывы в Apple App Store по ID приложения и стране.

$0.00015 / reviewПодробности →
Google Play
Отзывы Google Play

Отзывы в Google Play Store об Android-приложении.

$0.000195 / reviewПодробности →
Tripadvisor
Отзывы Tripadvisor

Отзывы об отелях, ресторанах и достопримечательностях на Tripadvisor: рейтинг, заголовок, текст, дата, тип поездки.

$0.00125 / reviewПодробности →
Booking.com
Отзывы об отелях Booking.com

Отзывы гостей об отелях Booking.com: оценка, что понравилось, что не понравилось, тип путешественника, дата.

$0.00285 / reviewПодробности →
Amazon
Отзывы Amazon

Отзывы покупателей на товар Amazon по ASIN: звёзды, заголовок, текст, дата, подтверждённая покупка. Отзывы идут страницами по 10 (maxPages во входных данных).

$0.00135 / reviewПодробности →
ИнструментЧто вы отправляетеПолезные параметры
google-maps-reviewsplaceIds или startUrlsreviewsSort (newest, lowestRanking…), language
trustpilot-reviewscompanyUrls (подходят домены)stars, sort (recency или relevance)
g2-reviewsmode product_reviews и productUrls (подходят slug)режимы product_search и category_browse
app-store-reviewsappIdscountry
google-play-reviewsappIdOrUrl (имя пакета или URL)sortBy newest, фильтр language
tripadvisor-reviewsstartUrls отелей, ресторанов или достопримечательностейдата since, ratings
booking-reviewsstartUrls отелейsortReviewsBy f_recent_desc, reviewScores
amazon-reviewsinput: по одному {asin, domainCode, sortBy, maxPages} на товарsortBy recent

Что приходит в ответе, зависит от сайта: Google Maps добавляет ответы владельца, Trustpilot — ответ компании, Tripadvisor — тип поездки, Booking.com — что гостю понравилось и не понравилось и тип путешественника, а Amazon — была ли покупка подтверждена.

04

Рецепты

Оповещения о новых низких оценках

Каждое утро запускайте trustpilot-reviews с "stars": ["1", "2"] и "sort": "recency" и google-maps-reviews с "reviewsSort": "newest". Храните уже просмотренные отзывы и публикуйте всё новое в канал команды из своего кода.

Охват всех филиалов

Найдите все свои точки через Поиск мест в Google Maps — он возвращает placeId каждой из них, — а затем передайте список в google-maps-reviews с "maxReviews": 10 на место.

Проверка каждого релиза приложения

После релиза запустите app-store-reviews для каждой страны, где вы продаёте, и google-play-reviews с "sortBy": "newest", а затем попросите модель разложить отзывы на баги, запросы функций и похвалу.

Сравнение с конкурентами на G2

Запустите g2-reviews в режиме product_reviews со slug вашего продукта и двух конкурентов и сравните, что рецензенты хвалят и за что критикуют.

Отзывы об отеле по типам гостей

booking-reviews возвращает для каждого отзыва, что понравилось, что не понравилось, и тип путешественника, так что видно, на что жалуются деловые путешественники, а на что — семьи; добавьте tripadvisor-reviews с since, равным дате вашего последнего запуска.

Подключив MCP-сервер, можно просто попросить Claude Code: «Возьми отзывы на Trustpilot с одной и двумя звёздами за этот месяц для нашего домена и самые новые отзывы Google Maps для трёх наших магазинов, а затем перечисли пять главных жалоб с примером цитаты для каждой. Задавай max_results в каждом запуске».

05

Сколько это стоит

Инструменты отзывов тарифицируются за каждый возвращённый отзыв, а некоторые ещё берут плату за запуск; актуальные цены — на карточках выше. При старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену отзыва, умноженную на max_results, — и списывает оплату за фактически возвращённые отзывы. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только отзывы, полученные до остановки, а запуск, отклонённый на старте, ничего не стоит.

Нет ни подписки, ни тарифа за каждый сайт: один предоплаченный баланс оплачивает и инструменты, и модели. Чтобы мониторинг оставался дешёвым, сортируйте по новизне и задавайте небольшой max_results — тогда каждая проверка забирает только то, что, скорее всего, появилось недавно. Цены всех инструментов — на странице цен.

06

Частые вопросы

?
Какие сайты с отзывами можно отслеживать?+

Google Maps, Trustpilot, G2, Apple App Store, Google Play, Tripadvisor, Booking.com и Amazon — каждый через свой инструмент, с одним API-ключом и одинаковым форматом запуска в JSON.

Как получать только отзывы, опубликованные после прошлой проверки?+

Сортируйте по новизне и держите лимит небольшим: Google Maps и Google Play сортируются по newest, Trustpilot — по recency, Booking.com — по f_recent_desc, а Amazon — по recent. Tripadvisor также принимает дату since. Сохраняйте уже просмотренное и пропускайте его при следующем запуске.

Можно ли фильтровать отзывы по звёздам?+

Да, на нескольких сайтах. Trustpilot принимает фильтр stars, Tripadvisor — ratings, а Booking.com — диапазоны оценок. Google Maps умеет сортировать начиная с самых низких оценок.

Получу ли я ответы владельца бизнеса?+

Отзывы Google Maps включают ответ владельца, а отзывы Trustpilot — ответ компании, если он есть.

Как превратить отзывы в отчёт?+

Отправьте текст отзывов модели через Models API с тем же ключом, например claude-haiku-5.5 или gemini-3-flash, и попросите сгруппировать жалобы, оценить тональность или набросать ответы. Токены модели и результаты инструментов списываются с одного баланса.

Сколько стоит мониторинг в месяц?+

В основном это зависит от того, сколько отзывов вы забираете, плюс плата за запуск у инструментов, где она есть, — а не от тарифа на каждый сайт или точку. Каждый запуск стоит не больше платы за вызов плюс цены отзыва, умноженной на max_results, и точную сумму вы видите в каждом запуске.

Цены на товары и бестселлеры вместе с отзывами — в разделе аналитика электронной коммерции. У отелей и аренды жилья своя страница: данные о путешествиях и недвижимости.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.