API di 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
Disponibilità
100,00%
30d · 1 chiamata
Richieste
1
30d
Risposta
7,5s
mediana · 30d

Prezzi e provider

Prezzi dell'API Google Local services: una sola API, 2 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Paghi
8,50 USD
0,85 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 117 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Google Local services in una sola richiesta

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.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta 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"
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-10-16 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo 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.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per 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[]può richiedere

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

  • hoursstringpuò richiedere

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

  • imagestringpuò richiedere

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

  • isOpenNowbooleanpuò richiedere

    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.

  • responseTimestringpuò richiedere

    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.

  • yearsInBusinessintegerpuò richiedere

    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.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API Google Local services

L'API Google Local services di AnyAPI restituisce dati Google come JSON normalizzato da una sola chiamata 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 instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate Google Local services tramite AnyAPI è riuscito, con un tempo di risposta mediano di 7,5 secondi su 1 chiamate misurate.

Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

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 risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 100,0% delle chiamate Google Local services tramite AnyAPI è riuscito, con un tempo di risposta mediano di 7,5 secondi su 1 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 117 chiamate Google Local services a 0,00085 USD ciascuna.

AnyAPI interroga la successiva delle sue 2 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/google.local_services con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.