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
Disponibilité
100,00%
30d · 1 appel
Requêtes
1
30d
Réponse
7,5s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Google Local services : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
8,50 $US
0,85 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 117 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Google Local services en une requête

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.
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.
{
  "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"
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-10-16 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet 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.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

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[]peut exiger

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

  • hoursstringpeut exiger

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

  • imagestringpeut exiger

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

  • isOpenNowbooleanpeut exiger

    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.

  • responseTimestringpeut exiger

    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.

  • yearsInBusinessintegerpeut exiger

    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.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Google Local services

L’API Google Local services d’AnyAPI renvoie des données Google en JSON normalisé à partir d’un appel 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 route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Google Local services passés par AnyAPI ont réussi, avec un temps de réponse médian de 7,5 secondes, sur 1 appels mesurés.

Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

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 réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 100,0% des appels Google Local services passés par AnyAPI ont réussi, avec un temps de réponse médian de 7,5 secondes, sur 1 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 117 appels Google Local services à 0,00085 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/google.local_services avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.