API Google

Google Local services API

Find the businesses Google lists in Local Services ads for a service in a US city (plumbers, electricians, cleaners...): up to 20 per request, each with phone, star rating, review count, category, service area and Google profile link.

POST/v1/run/google.local_services
Доступность
100,00%
30d · 1 вызов
Запросы
1
30d
Ответ
7,5s
медиана · 30d

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

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

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

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

Попробовать

Получите Google Local services одним запросом

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `yearsInBusiness` or `hours`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be null on a business that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.
{
  "data": {
    "items": [
      {
        "bid": "a1b2c3d4",
        "category": "general",
        "cid": "a1b2c3d4",
        "highlights": [
          "example"
        ],
        "hours": "example",
        "image": "https://example.com/image.jpg",
        "isOpenNow": true,
        "name": "Example title",
        "phone": "+1 555-0142",
        "pid": "a1b2c3d4",
        "position": 1,
        "profileUrl": "https://example.com/page",
        "rating": 4.6,
        "responseTime": "2024-01-15T09:30:00Z",
        "reviewCount": 12500,
        "serviceArea": "example",
        "yearsInBusiness": 2024
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}

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

Справочник

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

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

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

Тело запроса

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

  • locationstring

    Denver, CO

    The US city to search, with its state (e.g. Denver, CO or Austin, TX).

  • querystring

    plumber

    The service to find businesses for, in everyday words (e.g. plumber, electrician, house cleaning, roofer).

  • limitinteger

    5

    Maximum number of businesses to return (1-20, default 20). Google lists at most 20 businesses for one service in one city, so there are no further pages.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `yearsInBusiness` or `hours`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be null on a business that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

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

Ответ

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

each itemdata.items[]

Businesses Google lists in Local Services ads for the service and location, in Google's order. Populated whenever the provider has data for the entity.

  • bidstring

    Google Local Services business id (bid). Populated whenever the provider has data for the entity.

  • categorystring

    Google's service category for the business (e.g. Plumbers, Electricians). Populated whenever the provider has data for the entity.

  • cidstring

    Google customer id (cid) of the business. Populated whenever the provider has data for the entity.

  • highlightsstring[]может потребовать

    Selling points the business lists, such as Flat rate pricing or Free in-home estimate. Null when this source does not report them.

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

    Opening status as Google shows it at request time (e.g. Open 24 hours). Null when this source does not report it.

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

    Business logo or photo URL. Null when the business has none or this source does not report it.

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

    Whether the business was open when the request ran, as Google shows it. Null when this source does not report it.

  • namestring

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

  • phonestring

    Business phone number in E.164 format (e.g. +17205550123). Populated whenever the provider has data for the entity.

  • pidstring

    Google Local Services provider id (pid). Null when Google assigns none, which is common.

  • positioninteger

    1-based position of the business in Google's list. Populated whenever the provider has data for the entity.

  • profileUrlstring

    The business's Google Local Services profile page. Populated whenever the provider has data for the entity.

  • ratingnumber

    Average Google star rating out of 5. Null for a business with no reviews yet. Populated whenever the provider has data for the entity.

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

    How quickly the business usually replies, as Google shows it (e.g. Typically replies in 15 min). Null when Google shows none or this source does not report it.

  • reviewCountinteger

    Number of Google reviews behind the rating. Null for a business with no reviews yet. Populated whenever the provider has data for the entity.

  • serviceAreastring

    The area Google says the business serves (e.g. Denver). Populated whenever the provider has data for the entity.

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

    Years in business as Google shows it ("8+ years in business" reads 8). Null when Google shows none or this source does not report it.

top level
  • foundboolean

    True when Google listed at least one business for the service and location.

  • 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 Local services

AnyAPI Google Local services API возвращает данные Google в виде нормализованного JSON одним вызовом POST к /v1/run/google.local_services. Find the businesses Google lists in Local Services ads for a service in a US city (plumbers, electricians, cleaners...): up to 20 per request, each with phone, star rating, review count, category, service area and Google profile link. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Google Local services через AnyAPI завершились успешно, медианное время ответа 7,5 с, измерено вызовов: 1.

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

Find the businesses Google lists in Local Services ads for a service in a US city (plumbers, electricians, cleaners...): up to 20 per request, each with phone, star rating, review count, category, service area and Google profile link. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

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

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 117 вызовов Google Local services по 0,00085 USD за каждый.

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

Отправьте запрос POST на https://api.getanyapi.com/v1/run/google.local_services с вашим ключом 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.