Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Отзывы в Google Maps: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите места в Google Maps по названию или типу бизнеса в keyword. | $1.39 за 1 000 запросов | Норма |
Данные местаprofile | Получите место Google Maps по полному url. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Читайте отзывы об одном месте в Google Maps. | $1.39 за 1 000 запросов | Норма |
Отзывы автораcontributor_reviews | Читайте отзывы, которые написал один пользователь Google Maps, по ссылке на его профиль или числовому ID в contributor. | $1.39 за 1 000 запросов | Норма |
Карточки компанийbusiness_listings | Получайте компании из Google Maps по категории, например dentist или coffee_shop в category, и сужайте выборку по city, country, минимальному рейтингу или слову в названии. | $15.36 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Отзывы в Google Maps?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите места в Google Maps по названию или типу бизнеса в | keyword | country, language, location, page_token | Режим выдачи: Sync | Значения в каталоге: defaultLimit=15, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. Записей на странице: до 120; если записей больше 60, запрашивайте страницу с mode=async. | $1.39 за 1 000 запросов | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
profileДанные места Получите место Google Maps по полному | url | city, language, since, sort | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform |
reviewsОтзывы Читайте отзывы об одном месте в Google Maps. В каждом отзыве есть оценка, имя автора и число его отзывов, значок Local Guide, лайки, фото, детальные оценки и ответ владельца, если он есть. Язык выбирается через | url | lang, language, page_token, since, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Чтобы получить следующую страницу, передайте next_page_token как page_token, не меняя остальные параметры; каждая страница — отдельный вызов. Записей на странице: до 400; если записей больше 200, запрашивайте страницу с mode=async. | $1.39 за 1 000 запросов | id · text · rating · rating_scale · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform |
contributor_reviewsОтзывы автора Читайте отзывы, которые написал один пользователь Google Maps, по ссылке на его профиль или числовому ID в | contributor | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 200. | $1.39 за 1 000 запросов | id · text · rating · rating_scale · like_count · posted_at · posted_ago · url · image_urls · owner_response · owner_response_ago · place_name · place_address · place_type · place_data_id · lat · lng · reviewer_name · reviewer_id · reviewer_review_count · is_local_guide · local_guide_level · local_guide_points · platform |
business_listingsКарточки компаний Получайте компании из Google Maps по категории, например dentist или coffee_shop в | category | city, country, min_rating, name | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 20. | $15.36 за 1 000 запросов | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
Что означают параметры действия search в API Отзывы в Google Maps?
Находите места в Google Maps по названию или типу бизнеса в keyword. Получайте Google place ID, адрес, координаты, телефон, сайт, рейтинг, число отзывов и статус закрытия. Листайте страницы через page_token, всего до 120 записей. Чтобы получить больше 60 записей, нужен асинхронный режим.
keywordОбязательный- Название места, тип бизнеса или запрос по местам в Google Maps, например
dentistилиdentist in Chicago.searchнаходит места, но не ищет по тексту отзывов уже известной компании. countryНеобязательный- Код страны или региона для контекста поиска, например
us; по умолчаниюus. Не гарантирует, что каждая найденная компания находится в этой стране. languageНеобязательный- Язык запроса или содержимого страницы; по умолчанию
en. Для отзывов при указании обоих параметровlangпереопределяет это значение. Не гарантирует, что все отзывы написаны на этом языке. locationНеобязательный- Текст местоположения, который для
searchобъединяется сkeyword, напримерChicago. Не указывайте местоположение, противоречащее указанному вkeyword. page_tokenНеобязательный- Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте. Токены действуют 24 часа, каждая страница — это один вызов.
Что означают параметры действия profile в API Отзывы в Google Maps?
Получите место Google Maps по полному url. В ответе есть адрес, plus code, координаты, телефон, сайт, рейтинг, число отзывов, часы работы и статус временного или окончательного закрытия. Лучше использовать URL из search. Ссылка только с названием и координатами может указывать на другую компанию.
urlОбязательный- Полный URL места в Google Maps, желательно URL из результатов search с сохранённым
query_place_id. URL вида/place/, содержащий только название и координаты, может ненадёжно указывать на ту же компанию. Используйте profile для сведений о месте и reviews для отзывов о нём.Google Maps: ссылки на места и Place ID — Ссылки Google Maps указывают конкретное место напрямую через `query_place_id`, а не только по названию места или координатам. · Проверено cityНеобязательный- Ограничение по городу при поиске мест. Действие profile тоже принимает этот параметр, но он не может перенести известную компанию в другой город и не служит надёжной заменой URL места.
languageНеобязательный- Язык запроса или содержимого страницы; по умолчанию
en. Для отзывов при указании обоих параметровlangпереопределяет это значение. Не гарантирует, что все отзывы написаны на этом языке. sinceНеобязательный- Нижняя граница даты публикации отзывов, желательно в формате
YYYY-MM-DD. Это не дата открытия компании. То, что параметр есть у действия profile, не означает, что сведения о месте фильтруются по дате открытия. sortНеобязательный- Порядок отзывов:
newest(сначала новые) илиrelevance(порядок релевантности платформы). Для отзывов по умолчанию используетсяnewest. В profile параметр с тем же именем может влиять на прикреплённые данные отзывов, но не сортирует единственный объект места.Допустимые значения:newestrelevance
Что означают параметры действия reviews в API Отзывы в Google Maps?
Читайте отзывы об одном месте в Google Maps. В каждом отзыве есть оценка, имя автора и число его отзывов, значок Local Guide, лайки, фото, детальные оценки и ответ владельца, если он есть. Язык выбирается через lang, страницы — через page_token, до 400 записей. Чтобы получить больше 200 записей, нужен асинхронный режим.
urlОбязательный- Полный URL места в Google Maps, желательно URL из результатов search с сохранённым
query_place_id. URL вида/place/, содержащий только название и координаты, может ненадёжно указывать на ту же компанию. Используйте profile для сведений о месте и reviews для отзывов о нём.Google Maps: ссылки на места и Place ID — Ссылки Google Maps указывают конкретное место напрямую через `query_place_id`, а не только по названию места или координатам. · Проверено langНеобязательный- Язык отзывов, например
en,zhcnилиzhtw; полный список допустимых значений указан у действия. Имеет приоритет надlanguage. Не фильтрует по национальности автора отзыва.Допустимые значения:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu languageНеобязательный- Язык запроса или содержимого страницы; по умолчанию
en. Для отзывов при указании обоих параметровlangпереопределяет это значение. Не гарантирует, что все отзывы написаны на этом языке. page_tokenНеобязательный- Токен пагинации: чтобы получить следующую страницу, передайте next_page_token из предыдущего ответа; для первой страницы не указывайте его. Остальные параметры не меняйте. Токены действуют 24 часа, каждая страница — это один вызов.
sinceНеобязательный- Нижняя граница даты публикации отзывов, желательно в формате
YYYY-MM-DD. Это не дата открытия компании. То, что параметр есть у действия profile, не означает, что сведения о месте фильтруются по дате открытия. sortНеобязательный- Порядок отзывов:
newest(сначала новые) илиrelevance(порядок релевантности платформы). Для отзывов по умолчанию используетсяnewest. В profile параметр с тем же именем может влиять на прикреплённые данные отзывов, но не сортирует единственный объект места.Допустимые значения:newestrelevance
Что означают параметры действия contributor_reviews в API Отзывы в Google Maps?
Читайте отзывы, которые написал один пользователь Google Maps, по ссылке на его профиль или числовому ID в contributor. Каждый отзыв содержит оценку, текст, лайки, фото и ответ владельца, если он есть, а также место, к которому он относится (название, адрес, тип, координаты), число отзывов и уровень Local Guide автора. Даты относительные, например «13 hours ago», и находятся в posted_ago. По умолчанию 20 отзывов, максимум 200.
contributorОбязательный- Автор отзывов в Google Maps: ссылка на его профиль (https://www.google.com/maps/contrib/<numeric ID>) или просто ID из 10–32 цифр. Ссылки на авторов в результатах
reviewsведут на эту страницу.contributor_reviewsвозвращает до 200 отзывов, написанных этим человеком.
Что означают параметры действия business_listings в API Отзывы в Google Maps?
Получайте компании из Google Maps по категории, например dentist или coffee_shop в category, и сужайте выборку по city, country, минимальному рейтингу или слову в названии. У каждой компании есть адрес, координаты, телефон, сайт, рейтинг и число отзывов. До 20 компаний; сначала идут компании с наибольшим числом отзывов. Поле с ценой часто остаётся пустым, а статус закрытия не предоставляется.
categoryОбязательный- Категория компаний Google Maps для
business_listingsна английском в нижнем регистре, с подчёркиваниями вместо пробелов, напримерdentist,coffee_shopилиitalian_restaurant. cityНеобязательный- Название города, которому должен соответствовать адрес организации, например
Austin. Организации с адресами в других городах не включаются в результаты. countryНеобязательный- Двухбуквенный код страны, которому должен соответствовать адрес организации, например
usилиgb. min_ratingНеобязательный- Минимальный рейтинг в звёздах для
business_listings, от 1 до 5; допускаются дробные значения вроде4.5. nameНеобязательный- Слово, которое должно содержаться в названии компании в
business_listings, например бренд; компании без него в названии отбрасываются.
Как использовать API Отзывы в Google Maps
- 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":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Отзывы в Google Maps
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
API отзывов Google Maps: как выбрать правильную точку входа и фиксировать отзывы о местах
Разберитесь в различиях между Business Profile, Places API и получением отзывов о местах через EveryInfra, проверяйте идентификацию места, язык и фильтры по времени, сохраняйте изменения оценок и ответов владельца и чётко задавайте границы выборки, хранения и показа.
Читать статьюДедупликация данных о магазинах из Google Maps: Place ID не является постоянным идентификатором бизнеса
У одного места может быть несколько Place ID, а сами ID со временем меняются. Опираясь на официальную документацию, разбираем способы проверки при дедупликации сетевых магазинов, внутреннее сопоставление сущностей, историю переездов и ложные объединения.
Читать статьюКак мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива
Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.
Читать статьюВопросы об API Отзывы в Google Maps
Какие данные можно получить через API Отзывы в Google Maps?
Укажите в platform значение google_maps_reviews. В текущем каталоге: поиск, данные места, отзывы, отзывы автора и карточки компаний. Эти названия действий соответствуют разным объектам или представлениям Отзывы в Google Maps; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Отзывы в Google Maps?
Название места, тип бизнеса или запрос по местам в Google Maps, например dentist или dentist in Chicago. search находит места, но не ищет по тексту отзывов уже известной компании. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Отзывы в Google Maps?
Объявленная схема включает place_id, name, category и categories. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Отзывы в Google Maps возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.