API Google Maps

Google Maps Контакты API

Ищет на Google Maps компании и обогащает каждый результат контактными данными (почта, телефоны и профили в соцсетях с их сайтов), до 20 записей за запрос.

3,25 USD/1 тыс. запросов, оплата за запрос, без подписки.

coffee shop - Google Maps
google.com/maps/search/coffee%20shop
coffee shop in Austin, TX
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

hello@mananacoffeeaustin.comInstagramFacebookTikTok
Что вернул APIitems[0]
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [...],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
... ещё полей: 23
}
Доступность
99,98%
30d · Вызовов: 178 089
Запросы
178 755
30 дн. · по неделям, последние недель: 12
Ответ
10,5s
медиана · 30d

Цены и поставщики

Цена API Google Maps Контакты: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
32,50 USD
3,25 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (30) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите Google Maps Контакты одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `city` или `postalCode`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в записи о бизнесе, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 34 из 35. Все поля

{
  "found": true,
  "data": {
    "items": [
      {
        "placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "cid": "8234917364550128200",
        "name": "Mañana Coffee House",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Breakfast restaurant"
        ],
        "address": "612 W 6th St, Austin, TX 78701, USA",
        "street": "612 W 6th St",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78701",
        "countryCode": "US",
        "latitude": 30.2687,
        "longitude": -97.7469,
        "phone": "+1 512-555-0142",
        "website": "https://mananacoffeeaustin.com",
        "rating": 4.6,
        "reviewCount": 1284,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no",
        "emails": [
          "hello@mananacoffeeaustin.com",
          "events@mananacoffeeaustin.com"
        ],
        "phones": [
          "+1 512-555-0142"
        ],
        "instagrams": [
          "https://instagram.com/mananacoffeeatx"
        ],
        "facebooks": [
          "https://facebook.com/mananacoffeeatx"
        ],
        "twitters": [],
        "linkedIns": [],
        "youtubes": [],
        "tiktoks": [
          "https://tiktok.com/@mananacoffeeatx"
        ],
        "neighborhood": "Downtown",
        "domain": "mananacoffeeaustin.com",
        "language": "en",
        "rank": 1
      },
      {
        "placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "cid": "5127740981263455000",
        "name": "Radio Coffee & Beer",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "category": "Coffee shop",
        "address": "4204 Menchaca Rd, Austin, TX 78704, USA",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78704",
        "countryCode": "US",
        "latitude": 30.2277,
        "longitude": -97.7808,
        "phone": "+1 512-555-0187",
        "website": "https://radiocoffeeandbeer.com",
        "rating": 4.7,
        "reviewCount": 3021,
        "emails": [
          "info@radiocoffeeandbeer.com"
        ],
        "phones": [
          "+1 512-555-0187"
        ],
        "instagrams": [
          "https://instagram.com/radiocoffeeandbeer"
        ],
        "facebooks": [
          "https://facebook.com/radiocoffeeandbeer"
        ],
        "domain": "radiocoffeeandbeer.com",
        "rank": 2
      },
      {
        "placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "name": "Summer Moon Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "category": "Coffee shop",
        "address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78723",
        "countryCode": "US",
        "website": "https://summermooncoffee.com",
        "rating": 4.5,
        "reviewCount": 642,
        "emails": [
          "franchise@summermooncoffee.com"
        ],
        "instagrams": [
          "https://instagram.com/summermooncoffee"
        ],
        "domain": "summermooncoffee.com",
        "rank": 3
      }
    ]
  }
}

Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.

Справочник

Один запрос, один формат ответа.

Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.

Проверено 2026-11-21 · доступность и задержка измерены за 30d

Тело запроса

JSON, отправляется на этот эндпоинт.

  • locationstring

    Austin, TX

    Местоположение для поиска в свободной форме, лучше город и страна (например, Denver, USA).

  • querystring

    coffee shop

    То, что вы ввели бы в строку поиска Google Maps (например, dentist).

  • categoryFilterWordsarray

    Необязательный список названий категорий мест Google Maps, которые нужно оставить; результаты ограничиваются местами, категория которых совпадает с одной из них. Используйте названия категорий в нижнем регистре, как они показаны на Google Maps (например, ["dentist", "orthodontist"]). Не указывайте, чтобы включить все категории.

  • languagestring

    Двухбуквенный код языка для результатов (например, en).

  • limitinteger

    3

    Максимальное число возвращаемых результатов (1-20, по умолчанию 20).

  • placeMinimumStarsenum

    four

    Возвращать только места со средним рейтингом не ниже заданного: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) или fourAndHalf (4.5+). Места без отзывов исключаются. Не указывайте, чтобы не фильтровать по рейтингу.

  • requireFieldsarray

    Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `city` или `postalCode`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в записи о бизнесе, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.

  • websiteenum

    withWebsite

    Фильтр мест по тому, указан ли у них сайт: allPlaces (по умолчанию), withWebsite (только места с сайтом) или withoutWebsite (только места без сайта). Обогащение контактов берёт почту и профили в соцсетях с сайта места, поэтому withWebsite нацеливает на лиды, которые можно обогатить.

Вы отправляете. Небольшое тело JSON. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

each itemdata.items[]

Matching business records, each enriched with contact details scraped from the business website. Populated whenever the provider has data for the entity.

  • addressstring

    612 W 6th St, Austin, TX 78701, USA

    Full formatted street address.

  • categoriesstring[]

    Every Google Maps category listed for the business.

  • categorystring

    Coffee shop

    Primary business category.

  • cidstring

    8234917364550128200

    Google customer/place id (cid).

  • citystringможет потребовать

    Austin

    City the business is in.

  • countryCodestringможет потребовать

    US

    Two-letter country code.

  • domainstring

    mananacoffeeaustin.com

    Registrable domain of the business website.

  • emailsstring[]

    Email addresses scraped from the business website.

  • facebooksstring[]

    Facebook profile URLs found on the business website.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no

    Primary business photo URL.

  • instagramsstring[]

    Instagram profile URLs found on the business website.

  • languagestringможет потребовать

    en

    Two-letter language code of the listing Google served.

  • latitudenumber

    30.2687

    Latitude of the business in decimal degrees.

  • linkedInsstring[]

    LinkedIn profile URLs found on the business website.

  • longitudenumber

    -97.7469

    Longitude of the business in decimal degrees.

  • namestring

    Mañana Coffee House

    Business name. Populated whenever the provider has data for the entity.

  • neighborhoodstringможет потребовать

    Downtown

    Neighborhood the business is in.

  • phonestring

    +1 512-555-0142

    Business phone number in E.164 format, when listed on Google Maps.

  • phonesstring[]

    Additional phone numbers scraped from the business website.

  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Google Maps place id (stable identifier for the business). Populated whenever the provider has data for the entity.

  • postalCodestringможет потребовать

    78701

    Postal code of the business.

  • rankinteger

    1

    One-based position of the business in the Google Maps result order.

  • ratingnumber

    4.6

    Average star rating out of 5.

  • reviewCountnumber

    1284

    Total number of reviews.

  • statestringможет потребовать

    Texas

    State or region the business is in.

  • streetstringможет потребовать

    612 W 6th St

    Street portion of the address.

  • tiktoksstring[]

    TikTok profile URLs found on the business website.

  • twittersstring[]

    X/Twitter profile URLs found on the business website.

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Canonical Google Maps URL for the business. Populated whenever the provider has data for the entity.

  • websitestring

    https://mananacoffeeaustin.com

    The business website URL, when listed.

  • youtubesstring[]

    YouTube channel URLs found on the business website.

top level
  • foundboolean

    true

    True when the search returned at least one matching business.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

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

Вопросы и ответы

Об API Google Maps Контакты

AnyAPI Google Maps Контакты API возвращает данные Google Maps в виде нормализованного JSON одним вызовом POST к /v1/run/maps.contacts. Ищет на Google Maps компании и обогащает каждый результат контактными данными (почта, телефоны и профили в соцсетях с их сайтов), до 20 записей за запрос. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 3,25 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Google Maps Контакты через AnyAPI завершились успешно, медианное время ответа 10,5 с, измерено вызовов: 178 089.

Это стоит от 3,25 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Ищет на Google Maps компании и обогащает каждый результат контактными данными (почта, телефоны и профили в соцсетях с их сайтов), до 20 записей за запрос. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 100,0% вызовов Google Maps Контакты через AnyAPI завершились успешно, медианное время ответа 10,5 с, измерено вызовов: 178 089. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 30 вызовов Google Maps Контакты по 0,00325 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/maps.contacts с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.