API de Google Hotels
Google Hotels

API de Google Hotels: Buscar

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
Disponibilidad
99.44%
30d · 180 llamadas
Solicitudes
185
30d · semanal, últimas 12 sem.
Respuesta
4.5s
mediana · 30d

Precios y proveedores

Precios del endpoint Buscar de la API de Google Hotels: 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$15.00
US$1.50/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 66 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Buscar de Google Hotels 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 `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.
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": {
    "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"
}

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-11-20 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • checkInstring

    2026-12-20

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

  • checkOutstring

    2026-12-22

    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.

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

Respuesta

JSON, un valor de ejemplo por campo.

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[]se puede exigir

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

  • descriptionstringse puede exigir

    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.

  • totalPricenumberse puede exigir

    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.

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

Preguntas frecuentes

Acerca del endpoint Buscar de la API de Google Hotels

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

Cuesta desde US$1.50 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.

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 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 99.4% de las llamadas al endpoint Buscar de la API de Google Hotels a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 4.5 segundos en 180 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 66 llamadas a Buscar de Google Hotels a US$0.0015 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_hotels.search 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.
Más para llamar

Otros endpoints de Google Hotels