API de Google Hotels
Google Hotels

API de Google Hotels: Details

Get one hotel from Google Hotels by its property ID: address, phone, website, rating, nightly price, prices from each booking site, amenities and check-in times as normalized JSON.

POST/v1/run/google_hotels.details
Disponibilidad
100.00%
30d · 312 llamadas
Solicitudes
313
30d · semanal, últimas 12 sem.
Respuesta
2.3s
mediana · 30d

Precios y proveedores

Precios del endpoint Details 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 Details 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 `stars` or `images`, 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": {
    "address": "123 Main St",
    "amenities": [
      {
        "available": true,
        "name": "Example title"
      }
    ],
    "checkInTime": "2024-01-15T09:30:00Z",
    "checkOutTime": "2024-01-15T09:30:00Z",
    "currency": "USD",
    "images": [
      "https://example.com/image.jpg"
    ],
    "latitude": 37.7749,
    "longitude": -122.4194,
    "name": "Example title",
    "phone": "+1 555-0142",
    "pricePerNight": 19.99,
    "prices": [
      {
        "pricePerNight": 19.99,
        "site": "example",
        "totalPrice": 19.99,
        "url": "https://example.com/page"
      }
    ],
    "propertyToken": "a1b2c3d4",
    "rating": 4.6,
    "reviewsCount": 12500,
    "stars": 5,
    "totalPrice": 19.99,
    "website": "https://example.com/page"
  },
  "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.

  • propertyTokenstring

    ChcImaG28Zbom8uuARoKL20vMDNncTd2NBAB

    Google Hotels property ID of the hotel, the propertyToken google_hotels.search returns for it.

  • 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 `stars` or `images`, 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

The hotel, or null when it was not found.

  • addressstring

    Street address. Populated whenever the provider has data for the entity.

  • checkInTimestring

    Earliest check-in time, 24-hour HH:MM local time. Populated whenever the provider has data for the entity.

  • checkOutTimestring

    Latest check-out time, 24-hour HH:MM local time. Populated whenever the provider has data for the entity.

  • currencystring

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

  • imagesstring[]

    Preview photo URLs of the hotel, or null when unknown.

  • 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.

  • phonestring

    Phone number as published. Populated whenever the provider has data for the entity.

  • 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.

  • 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.

  • starsintegerse puede exigir

    Hotel star class (1-5), or null when unknown.

  • totalPricenumberse puede exigir

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

  • websitestring

    The hotel's own website. Populated whenever the provider has data for the entity.

each amenitydata.amenities[]

Amenities Google lists for the hotel, each with whether the hotel offers it. Populated whenever the provider has data for the entity.

  • availableboolean

    Whether the hotel offers it. Populated whenever the provider has data for the entity.

  • namestring

    Amenity name (e.g. Wi-Fi, Pool).

each pricedata.prices[]

Nightly prices offered by each booking site for the requested dates. Populated whenever the provider has data for the entity.

  • pricePerNightnumber

    Nightly price on this site, in the response currency. Populated whenever the provider has data for the entity.

  • sitestring

    Booking site name (e.g. Booking.com).

  • totalPricenumberse puede exigir

    Total price for the stay on this site, or null when unknown.

  • urlstring

    Booking link for this offer. Populated whenever the provider has data for the entity.

top level
  • foundboolean

    Whether the hotel was 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 Details de la API de Google Hotels

El endpoint Details de AnyAPI para Google Hotels devuelve datos de Google Hotels como JSON normalizado con una sola llamada POST a /v1/run/google_hotels.details. Get one hotel from Google Hotels by its property ID: address, phone, website, rating, nightly price, prices from each booking site, amenities and check-in times 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 100.0% de las llamadas al endpoint Details de la API de Google Hotels a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.3 segundos en 312 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.

Get one hotel from Google Hotels by its property ID: address, phone, website, rating, nightly price, prices from each booking site, amenities and check-in times 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 100.0% de las llamadas al endpoint Details de la API de Google Hotels a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.3 segundos en 312 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 Details 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.details 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