google-maps/
reviews

Собирайте публичные отзывы по известным URL Google Maps: нормализованный текст, ссылки на авторов, оценки, ссылки на источник, метки времени, ссылки на место и доступные медиафайлы.

Google Maps Reviews API

Отзывы о местах
Фильтр по дням
Нормализованные записи отзывов
0,15 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Google Maps Reviews

Отзывы Google Maps — это публичные записи обратной связи о местах, которые могут содержать текст, ссылку на автора, оценку, ссылки на источник и объект отзыва, время публикации и сбора, а также медиафайлы. На их основе можно строить датасеты отзывов с привязкой к источнику и сравнивать известные места или периоды сбора.

Возможности Google Maps Reviews API

  • Пакетный ввод известных URLОтправляйте один или несколько поддерживаемых URL на google.com или goo.gl в одной асинхронной задаче, без поиска мест через отдельный сервис идентификаторов.
  • Необязательное окно в дняхПрименяйте одно положительное значение days_limit ко всем строкам отправленных URL, когда сценарию нужны только недавние отзывы.
  • Стабильные записи отзывовПолучайте идентификатор отзыва, текст, поля автора, оценку, ссылки на место, метки времени, исходный URL и доступные медиафайлы по схеме review v1.0.

Параметры Google Maps Reviews API

ПараметрыОбязательныйОписание
urlsОбязательныйОдин или несколько непустых URL на google.com, любом поддомене google.com, goo.gl или поддомене goo.gl, разделенных запятыми или переводами строки. Для сбора отзывов используйте известные URL мест Google Maps.
days_limitНеобязательныйНеобязательное положительное целое число, которое применяется к каждой входной строке провайдера как окно давности отзывов. Не указывайте его, чтобы не передавать фильтр по дням.
results_limitНеобязательныйНеобязательное целое число от 1 до 2 000, ограничивающее общее число отзывов, сохраняемых для задачи. По умолчанию 100; при ограниченной доступности источника строк может быть меньше.

Как использовать Google Maps Reviews API

Отправьте известные URL Google Maps, отслеживайте асинхронную задачу и читайте сохраненные записи отзывов через курсор результатов задачи.

  1. Подготовьте один или несколько поддерживаемых URL мест Google Maps на google.com или goo.gl.
  2. Отправьте urls и при необходимости days_limit и results_limit методом POST на /v1/google-maps/reviews.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Сценарии использования Google Maps Reviews API

  • Датасеты отзывов об известных местах: Готовьте тексты отзывов, оценки, время публикации и ссылки на источник для заданного набора публичных URL мест.
  • Исследование авторов с учетом источника: Сохраняйте доступные имена авторов, имена пользователей, ссылки на профили и URL отзывов, чтобы записи можно было проследить до их публичного контекста.
  • Сравнение недавних периодов: Запускайте один и тот же набор мест с задокументированными значениями days_limit в разное время, чтобы сравнивать ограниченные выборки, не претендуя на полноту истории.
  • Архивы отзывов с медиафайлами: Храните доступные медиафайлы отзывов рядом с текстом, оценкой, ссылкой на место и временем сбора в нормализованной исследовательской записи.

Практические советы по Google Maps Reviews API

  • Отправляйте разрешимые URL Maps на google.com или goo.gl; одно лишь название места, аккаунт Google Business Profile или Place ID не принимается как элемент urls.
  • Используйте days_limit, только когда окно в целых положительных днях имеет смысл; без него строка провайдера отправляется без этого фильтра.
  • Воспринимайте results_limit как единый общий потолок сохраненных результатов для всего пакета URL, а не как обещание для каждого URL.
  • Не путайте results_limit при отправке с limit при чтении задачи: последний задает размер страницы от 1 до 500 и работает с непрозрачным курсором.
  • Допускайте отсутствие текста, атрибутов автора, оценки, ссылок на объект, меток времени и медиафайлов, если публичный источник их не показывает.

Помимо Google Maps Reviews API, используйте эти API, когда нужен другой тип публичных данных Google Maps.

  • Google Maps Search API — Ищите публичные места Google Maps по запросу и местоположению: нормализованные название, адрес, контакты, рейтинг, число отзывов, URL и координаты.
  • Google Maps Place Details API

Другие платформы

Объединяйте данные Google Maps с публичными данными других поддерживаемых соцсетей.

Google Maps Reviews API — FAQ

Google Maps Reviews API — это программный интерфейс для сбора публичных записей отзывов по известным URL Google Maps в стабильную схему отзывов. Он возвращает только данные, доступные через поддерживаемый публичный способ сбора, и не предоставляет действий по управлению Google Business Profile с входом в аккаунт.

Среда выполнения принимает непустые URL, хост которых — google.com, поддомен google.com, goo.gl или поддомен goo.gl. Чтобы получить полезные отзывы, отправляйте известные URL мест Google Maps, а не названия или отдельные идентификаторы.

days_limit необязателен и должен быть целым числом не меньше 1. Если он указан, адаптер провайдера копирует одно и то же значение в каждую входную строку URL; если не указан, поле days_limit не передается.

По умолчанию results_limit равен 100 и принимает целые числа от 1 до 2 000. Запрос к провайдеру получает этот лимит, а среда выполнения также прекращает сохранять строки, когда общий итог по задаче его достигает, поэтому число URL, окно в днях и доступность публичного датасета могут дать меньше результатов.

Схема review v1.0 может содержать id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url и media. Объект author раскрывается в идентификатор, имя пользователя, имя, URL профиля, URL аватара и допускающие null признаки аккаунта.

Базовой платы за задачу нет. Запрос резервирует 0,15 кредита за каждый ожидаемый результат исходя из results_limit (или 100, если он не указан), затем списывает 0,15 кредита за каждый фактически сохраненный результат и возвращает неиспользованные зарезервированные кредиты; пустой результат стоит ноль.