API Google Hotels
Google Hotels

Google Hotels Recherche API

Search Google Hotels by destination and dates and get hotels with their Google property ID, nightly price, rating, review count, coordinates, star class and photos as normalized JSON.

POST/v1/run/google_hotels.search
Disponibilité
99,52%
30d · 207 appels
Requêtes
212
30 j · par semaine, 12 dernières sem.
Réponse
4,6s
médiane · 30d

Tarifs

Tarifs de l’API Google Hotels Recherche

Un fournisseur marqué Hors service a cessé de répondre de façon fiable et a été retiré de la rotation, donc vos appels vont aux autres. Il est remis en service de lui-même dès qu’il répond de nouveau de façon fiable.

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

Essayer

Obtenez Google Hotels Recherche 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 `totalPrice` or `amenities`, 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 absent on a hotel 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": {
    "currency": "USD",
    "hotels": [
      {
        "amenities": [
          "example"
        ],
        "description": "A short example description of this item.",
        "images": [
          "https://example.com/image.jpg"
        ],
        "latitude": 37.7749,
        "longitude": -122.4194,
        "name": "Example title",
        "pricePerNight": 19.99,
        "propertyToken": "a1b2c3d4",
        "rating": 4.6,
        "reviewsCount": 12500,
        "stars": 5,
        "totalPrice": 19.99
      }
    ]
  },
  "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-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • checkInstring

    2026-12-21

    Check-in date in YYYY-MM-DD format (e.g. 2027-04-13). Today or later.

  • checkOutstring

    2026-12-23

    Check-out date in YYYY-MM-DD format (e.g. 2027-04-15). After the check-in date.

  • countryenum

    us

    Two-letter lowercase ISO 3166-1 country code of the destination (e.g. us, pt, jp). It must be the country the hotels are in: results are searched from that country.

  • querystring

    hotels near times square new york

    What to search for, usually a destination or landmark (e.g. hotels near times square new york).

  • adultsinteger

    Number of adult guests (default 2).

  • childrenAgesarray

    Age of each child guest, one entry per child (e.g. [5, 8] for two children aged 5 and 8). Omit it when no children are staying.

  • currencystring

    ISO 4217 currency code for prices (e.g. USD, EUR, JPY; default USD).

  • 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 `totalPrice` or `amenities`, 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 absent on a hotel 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.
Google Hotels

Réponse

JSON, une valeur d’exemple par champ.

datadata

Result payload, or null when nothing was found.

  • currencystring

    ISO 4217 currency code every price in this response is in. Populated whenever the provider has data for the entity.

each hoteldata.hotels[]

Hotels matching the search, in Google's order. Populated whenever the provider has data for the entity.

  • amenitiesstring[]peut exiger

    Highlighted amenities (e.g. Free Wi-Fi, Parking), or null when unknown.

  • descriptionstringpeut exiger

    Short description of the hotel, or null when unknown.

  • imagesstring[]

    Preview photo URLs of the hotel.

  • latitudenumber

    Latitude of the hotel. Populated whenever the provider has data for the entity.

  • longitudenumber

    Longitude of the hotel. Populated whenever the provider has data for the entity.

  • namestring

    Hotel name.

  • pricePerNightnumber

    Lowest nightly price for the requested dates and guests, in the response currency, or null when no price is offered. Populated whenever the provider has data for the entity.

  • propertyTokenstring

    Google Hotels property ID. Pass it to google_hotels.details for this hotel's full record.

  • ratingnumber

    Average guest rating out of 5, or null when the hotel has no ratings. Populated whenever the provider has data for the entity.

  • reviewsCountinteger

    Number of guest reviews. Populated whenever the provider has data for the entity.

  • starsinteger

    Hotel star class (1-5), or null when the property has none.

  • totalPricenumberpeut exiger

    Lowest total price for the whole stay, in the response currency, or null when unknown.

top level
  • foundboolean

    Whether any hotels were found.

  • 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 Hotels Recherche

L’API Google Hotels Recherche d’AnyAPI renvoie des données Google Hotels en JSON normalisé à partir d’un appel POST à /v1/run/google_hotels.search. Search Google Hotels by destination and dates and get hotels with their Google property ID, nightly price, rating, review count, coordinates, star class and photos as normalized JSON. AnyAPI renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 4,80 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,5% des appels Google Hotels Recherche passés par AnyAPI ont réussi, avec un temps de réponse médian de 4,6 secondes, sur 207 appels mesurés.

Elle coûte à partir de 4,80 $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é.

Search Google Hotels by destination and dates and get hotels with their Google property ID, nightly price, rating, review count, coordinates, star class and photos as normalized JSON. 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, 99,5% des appels Google Hotels Recherche passés par AnyAPI ont réussi, avec un temps de réponse médian de 4,6 secondes, sur 207 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 20 appels Google Hotels Recherche à 0,0048 $US chacun.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/google_hotels.search 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.