Ко всем API
Независимые данные Google Maps

Google Maps API

Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.

Доступные API Google Maps

Используйте Search для поиска по запросу и местоположению, Place Details — для известных URL Maps, а Reviews — для ограниченного сбора публичных отзывов.

Какие данные Google Maps можно получить?

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

Идентификаторы места

Получайте доступные ID мест, названия, категории, исходные URL, типы записей и метки времени сбора.

Адреса и география

Сохраняйте доступные отформатированные адреса, метки местоположения, города, регионы, страны, широту и долготу.

Публичные контакты

Собирайте публичные номера телефонов и сайты, если они есть в результате поиска.

Рейтинги и число отзывов

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

Описания и категории

Используйте доступный текст описания и метки категорий, чтобы классифицировать результаты и составлять шорт-листы мест.

Метаданные задачи и пагинации

Отслеживайте статус задачи и result_count, затем листайте сохраненные записи PlaceItem с помощью next_cursor и has_more.

Текст местоположения и координаты

Google Maps Search всегда требует query и location. В текущей спецификации координаты — это необязательный дополнительный контекст, а не замена location.

Вариант входных данныхПоведениеКогда использовать
только locationТекст местоположения объединяется с query для поискаПоиск по городу, району, ориентиру или адресу
location и обе координатыlocation остается обязательным, а координаты передаются как lat и longЕсть проверенный географический центр
location и одна координатаПереданная координата передается отдельноТолько если частичный географический контекст задан намеренно
country и zoom_levelНеобязательный контекст передается вместе со строкой поискаЗапросу нужна подсказка о стране или явный масштаб от 0 до 21

Как работает API Google Maps

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

  1. 1. Определите поиск мест

    Выберите конкретный query и обязательный location, затем добавьте только тот проверенный необязательный географический контекст, который вам нужен.

  2. 2. Отправьте задачу и отслеживайте ее

    Отправьте POST-запрос, сохраните task_id и опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.

  3. 3. Читайте нормализованные места

    Обрабатывайте data.results.items и переходите по next_cursor, пока has_more равно true.

Поиск публичных мест

Отправьте query и location с небольшим лимитом результатов, затем читайте нормализованные результаты PlaceItem через общий эндпоинт задач.

curl -X POST "https://api.socq.ai/v1/google-maps/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Типичные сценарии использования API Google Maps

Поиск местных компаний

Находите публичные компании, соответствующие категории или услуге, в пределах города, района, ориентира или адреса.

Обогащение данных о местах

Добавляйте доступные контакты, адрес, категорию, рейтинг, число отзывов, URL и координаты к имеющимся кандидатам-местам.

Географические снимки рынка

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

Очереди проверки

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

Ограничения и политика публичных данных

Результаты — это публичные записи на определенный момент. Доступность поиска и полнота полей зависят от того, что источник показывает по переданному запросу.

  • query и location — обязательные непустые строки; location нельзя заменить координатами.
  • country, latitude, longitude и zoom_level необязательны; текущая реализация принимает latitude и longitude независимо друг от друга.
  • zoom_level должен быть целым числом от 0 до 21, а results_limit по умолчанию равен 100 и принимает значения от 1 до 2 000.
  • results_limit — это максимум для сбора, а параметр limit в GET-запросе задачи управляет размером каждой страницы ответа с сохраненными результатами.
  • В публичных результатах могут отсутствовать описания, категории, контакты, рейтинги, число отзывов, URL или отдельные географические поля.
  • Повторяющиеся идентификаторы сохраняются в задаче один раз, поэтому result_count может быть меньше числа строк, полученных из источника.

Частые вопросы об API Google Maps

Что такое API Google Maps?

API Google Maps асинхронно ищут публичные места, получают данные по известным URL мест и собирают публичные отзывы в виде нормализованных записей. Search принимает query и location и возвращает записи PlaceItem с доступными полями идентичности, адреса, контактов, рейтинга, числа отзывов, URL и координат.

Что требуется для Search?

Search требует непустые строки query и location. Параметры country, latitude, longitude, zoom_level и results_limit необязательны.

Чем пагинация сбора отличается от пагинации ответа?

results_limit ограничивает число записей, собираемых по переданному поиску. После успешного завершения эндпоинт задач возвращает сохраненные записи страницами, размер которых управляется отдельными параметрами limit и next_cursor.

Почему поля места могут быть null?

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

Сколько стоят результаты Google Maps Search?

Каждое сохраненное место стоит 0,15 кредита. Предварительная оценка использует results_limit или 100, если он не указан, а при успешном завершении расчет ведется по фактическому числу сохраненных результатов.

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

Google Play API

Собирайте публичные данные о приложениях Google Play, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.

Amazon API

Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.

Apple App Store API

Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.

SEO API

Запрашивайте органическую выдачу Google в реальном времени, сравнивайте спрос и сложность продвижения по ключевым словам, расширяйте исходные запросы, находите ключевые слова и страницы, которые обеспечивают сайту видимость в поиске, классифицируйте поисковый интент и собирайте результаты Google News, Google Images, Google Autocomplete, Bing и YouTube. Все эндпоинты используют один API-ключ SocQ, асинхронный процесс задач и нормализованный формат результатов.

Telegram API

Читайте открытые Telegram-каналы по ссылкам t.me: профили каналов с числом подписчиков, публикации с просмотрами и реакциями, отдельные публикации, комментарии из групп обсуждения, похожие каналы и поиск по всей истории.

Link in Bio API

Превращайте единственную ссылку из био автора в Instagram, TikTok или YouTube в структурированные данные: отображаемое имя, био, аватар, указанный контактный email, связанные профили в соцсетях и каждую кнопку страницы с заголовком и адресом.