API para Google

API para 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.

POST/v1/run/google.local_services
Disponibilidade
100,00%
30d · 1 chamada
Requisições
1
30d
Resposta
7,5s
mediana · 30d

Preços e provedores

Preços do endpoint Local services da API para Google: uma API, 2 provedores intercambiáveis

O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.

Você paga
US$ 8,50
US$ 0,85/mil req., só pelo que você usar. Sem plano mensal.
Suas primeiras 117 requisições são grátis com o saldo inicial de US$ 0,10.

Teste

Obtenha Local services do Google em uma só requisição

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.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "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"
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Uma requisição, um formato de resposta.

Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.

Última verificação em 2026-10-16 · disponibilidade e latência medidas em 30d

Corpo da requisição

JSON, enviado via POST para este endpoint.

  • 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.

Você envia. Um corpo JSON pequeno. Os valores mostrados são exemplos para você trocar pelos seus.

Resposta

JSON, um valor de exemplo por campo.

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[]pode ser exigido

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

  • hoursstringpode ser exigido

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

  • imagestringpode ser exigido

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

  • isOpenNowbooleanpode ser exigido

    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.

  • responseTimestringpode ser exigido

    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.

  • yearsInBusinessintegerpode ser exigido

    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.

Você recebe. Campos nomeados e tipados, no mesmo formato, seja qual for a fonte que responder.

Dúvidas frequentes

Sobre o endpoint Local services da API para Google

O endpoint Local services da AnyAPI para Google retorna dados de Google em JSON normalizado com uma chamada POST para /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. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,85 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Local services da API para Google feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,5 segundos, em 1 chamadas medidas.

Custa a partir de US$ 0,85 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

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. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Local services da API para Google feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 7,5 segundos, em 1 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.

Sim. Uma conta nova da AnyAPI começa com US$ 0,10 de saldo grátis, sem cartão, o que cobre 117 chamadas de Local services do Google a US$ 0,00085 cada.

A AnyAPI consulta a próxima das suas 2 fontes na mesma requisição, começando pela mais barata, então a queda de uma fonte não derruba sua chamada.

Envie uma requisição POST para https://api.getanyapi.com/v1/run/google.local_services com sua chave da AnyAPI em um cabeçalho "Authorization: Bearer" e a entrada como corpo JSON. A mesma chave e a mesma carteira funcionam em todos os endpoints da AnyAPI.

Não. Você adiciona dólares a um único saldo pré-pago da AnyAPI e cada requisição desconta dele. Não há plano mensal nem mínimo, e o mesmo saldo paga todos os endpoints da AnyAPI.

Sim. Instale @getanyapi/sdk pelo npm para TypeScript ou getanyapi pelo pip para Python. Os dois chamam todos os endpoints da AnyAPI com a mesma chave, e qualquer cliente HTTP também funciona.

Sim. Um agente pode se conectar ao servidor MCP da AnyAPI em https://api.getanyapi.com/mcp, ou criar a própria chave de teste grátis com um único POST sem autenticação para https://api.getanyapi.com/agent/signup e chamar este endpoint por HTTP.