Создайте ключ API
Создайте учётные данные в своём рабочем пространстве API и храните их в секретной конфигурации сервера или клиента. REST и MCP используют одну и ту же квоту API.
Открыть ключи APIG Maps Crawl для разработчиков
Ищите компании, читайте публичные отзывы и просматривайте фото и видео мест. Работайте с синхронным REST API или дайте своему ИИ-ассистенту доступ через MCP.
Структурированный JSON
Результаты в том же ответе
REST + MCP
Используйте своё приложение или ИИ-клиент
Единая квота API
Общая для запросов API и MCP
Выберите свои данные
Начните с поиска компаний, затем используйте feature ID места, чтобы запросить отзывы или элементы галереи. У каждого API свои примеры и справочник полей.
Ваш первый запрос к API
Используйте ключ API в заголовке Authorization. Изучите форматы запросов ниже, затем следуйте быстрому старту, чтобы сделать первый вызов.
Полный контракт смотрите в документации API.
curl https://gmapscrawl.com/api/v1/search \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seattle-coffee-search-001" \
-d '{"q":"coffee shops in Seattle","page":1,"extra":false}'Пример пустого ответа. Реальный поиск возвращает доступные компании. Держите ключ API на стороне сервера; используйте новый ключ идемпотентности для новой работы и сохраняйте его для неизменённого повтора.
{
"data": {
"total": 0,
"params": {
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false
},
"businesses": []
},
"request_id": "req_example",
"schema_version": "2026-09-22"
}API возвращает JSON в том же ответе. После таймаута повторите неизменённое тело с тем же Idempotency-Key. Тестовые учётные данные возвращают имитированные данные и не расходуют вашу квоту.
Работа со стандартным HTTP
Создайте учётные данные в своём рабочем пространстве API и храните их в секретной конфигурации сервера или клиента. REST и MCP используют одну и ту же квоту API.
Открыть ключи APIИщите по ключевому слову и местоположению. Для отзывов и фото укажите имеющийся у вас feature ID Google Maps или прочитайте place.dataId из результата поиска.
Следовать быстрому стартуОбрабатывайте возвращённую страницу в своём приложении. Соблюдайте правила пагинации эндпоинта, проверяйте отсутствующие поля и сохраняйте ключ идемпотентности запроса для повторных попыток.
Понять пагинациюСоздайте что-то полезное
Используйте возвращённые записи как входные данные для собственных исследований, отчётности и внутренних процессов.
Найдите категорию и местоположение, затем организуйте доступные названия компаний, адреса, сайты, номера телефонов и рейтинги в своём приложении.
Получите публичные отзывы о месте, чтобы изучить отзывы клиентов. Выберите единый порядок сортировки и пройдите по доступным страницам для анализа.
Получите доступные ссылки на фото и видео места. Сохраняйте ссылку на исходную галерею вместе с записями, чтобы команда могла посмотреть исходный контекст.
Ваш агент подключён
Подключите сервер MCP для обнаруживаемых инструментов или установите Agent Skill для переиспользуемых инструкций процесса и REST-запасного варианта.
Пример задачи для подключённого агента
«Найди одну страницу кофеен в Сиэтле. Верни доступные названия, сайты и рейтинги и укажи на отсутствующие данные.»
Запросы расходуют вашу квоту API. С тестовыми учётными данными результаты имитируются.
Спланируйте интеграцию
Каждая успешная реальная страница, включая пустую, расходует один запрос API. REST и MCP делят ваш тариф API; квоты Online и Extension отдельные.
Начните с одной страницы, проверьте возвращённые поля и задайте таймаут клиента, подходящий эндпоинту. Для повторов используйте тот же Idempotency-Key с неизменённым телом запроса.
Лимиты тарифа, ограничения частоты, доступность источника и обогащение влияют на реальные запросы. Тестовые учётные данные возвращают имитированные фикстуры и не расходуют вашу реальную квоту.
Используйте страницы эндпоинтов для лимитов запросов и полей результата. На странице цен указаны текущие включённые запросы и тарифы платного превышения.
G Maps Crawl предоставляет API поиска компаний, публичных отзывов о местах и фото/галерей мест. Search возвращает записи компаний; Reviews и Photos используют feature ID Google Maps, чтобы вернуть одну страницу для конкретного места.
Да. API используют HTTP-запросы и JSON, поэтому их можно вызывать через Python, JavaScript, cURL или другой HTTP-клиент. Каждая страница API содержит примеры запросов и пример ответа.
Публичные API Search, Reviews и Photos возвращают JSON в том же ответе. Они не требуют опроса задач или настройки вебхуков. Следуйте указаниям эндпоинта по таймаутам и повторам.
REST позволяет вашему приложению напрямую вызывать эндпоинт. MCP делает инструменты доступными совместимому ИИ-клиенту. Agent Skill предоставляет инструкции процесса и вспомогательные скрипты. Запросы REST и MCP требуют учётных данных API и расходуют вашу квоту API.
Используйте имеющийся feature ID Google Maps или скопируйте place.dataId из подходящей записи в массиве data.businesses API Search. Передайте это значение как fid в API Reviews или Photos.
Нет. Возвращённые поля зависят от источника и выбранной операции. Проверяйте отсутствующие значения и доступные отметки времени наблюдений перед использованием данных. Успешный ответ может содержать пустую страницу.
Следующий шаг
Создайте ключ API, начните с одного запроса и изучите данные, которые может использовать ваше приложение.