API de Google

API de 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
Disponibilidad
100.00%
30d · 1 llamada
Solicitudes
1
30d
Respuesta
7.5s
mediana · 30d

Precios y proveedores

Precios del endpoint Local services de la API de Google: una API, 2 proveedores intercambiables

El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.

Pagas
US$8.50
US$0.85/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 117 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Local services de Google en una sola solicitud

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 en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta 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"
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-10-16 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a 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.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo 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[]se puede exigir

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

  • hoursstringse puede exigir

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

  • imagestringse puede exigir

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

  • isOpenNowbooleanse puede exigir

    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.

  • responseTimestringse puede exigir

    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.

  • yearsInBusinessintegerse puede exigir

    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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Local services de la API de Google

El endpoint Local services de AnyAPI para Google devuelve datos de Google como JSON normalizado con una sola llamada POST a /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 enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Local services de la API de Google a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 7.5 segundos en 1 llamadas medidas.

Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto 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. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 100.0% de las llamadas al endpoint Local services de la API de Google a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 7.5 segundos en 1 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 117 llamadas a Local services de Google a US$0.00085 cada una.

AnyAPI consulta la siguiente de sus 2 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/google.local_services con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.