> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Hotel Details

> Get a hotel's address, amenities, location scores, guest rating breakdown, review topics and offers from every booking site.

# Google Hotel Details

Everything Google Hotels knows about one property in a single row. You get the address, phone and website, check-in time, the amenity list, scores for the neighborhood's transit, restaurants and attractions, the share of reviews at each star rating, the topics guests praise or complain about, ratings on other review sites, and the price each booking site charges for your stay. Ideal for rate-parity checks, competitive set analysis or a richer hotel page in your own product.

```json theme={"dark"}
{
  "hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
  "currency": "USD"
}
```

Provide a hotel\_id from the id field of Google Hotels Search. Add check\_in and check\_out (YYYY-MM-DD) to get offers for those dates; otherwise offers are for one night from tomorrow. Each request costs 2 credits and returns one row; an unknown hotel\_id returns no rows and is still charged.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Hotel ID; pass it to Hotel Details or Hotel Prices. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | URL of the hotel on Google Hotels. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `name` | `string` | Yes | Name of the hotel. |
| `text` | `string` | Yes | Description of the hotel (details only). |
| `stars` | `integer` | Yes | Star class of the hotel, from 1 to 5. |
| `rating` | `number` | Yes | Average guest rating from 1 to 5. |
| `reviews_count` | `integer` | Yes | Number of guest reviews. |
| `price` | `object` | Yes | Lowest nightly price for the stay. |
| `price.amount` | `number` | Yes | Price as a number. |
| `price.currency` | `string` | Yes | Three-letter currency code of the price. |
| `price.formatted` | `string` | Yes | Price with its currency code, such as `USD 176`. |
| `check_in` | `string` | Yes | Check-in date the price is for, in YYYY-MM-DD format. |
| `check_out` | `string` | Yes | Check-out date the price is for, in YYYY-MM-DD format. |
| `is_sponsored` | `boolean` | Yes | Whether the listing is a sponsored placement. |
| `address` | `string` | Yes | Street address of the hotel (details only). |
| `phone` | `string` | Yes | Phone number of the hotel (details only). |
| `website` | `string` | Yes | Official website of the hotel (details only). |
| `location` | `object` | Yes | Where the hotel is. |
| `location.name` | `string` | Yes | Neighborhood of the hotel (details only). |
| `location.city` | `string` | Yes | City name. |
| `location.region` | `string` | Yes | Region, state, or province name. |
| `location.country` | `string` | Yes | Country or territory name or code. |
| `location.latitude` | `number` | Yes | Latitude in decimal degrees. |
| `location.longitude` | `number` | Yes | Longitude in decimal degrees. |
| `location_scores` | `object` | Yes | Location ratings from 1 to 5 (details only). |
| `location_scores.overall` | `number` | Yes | Overall location score. |
| `location_scores.things_to_do` | `number` | Yes | Score for nearby attractions and activities. |
| `location_scores.restaurants` | `number` | Yes | Score for nearby restaurants. |
| `location_scores.transit` | `number` | Yes | Score for public transport access. |
| `location_scores.airport_access` | `number` | Yes | Score for access to the airport. |
| `check_in_time` | `string` | Yes | Earliest check-in time, as HH:MM (details only). |
| `check_out_time` | `string` | Yes | Latest check-out time, as HH:MM (details only). |
| `amenities` | `array<string>` | Yes | Amenities the hotel offers, such as `Free Wi-Fi` or `Pool` (details only). |
| `rating_distribution` | `array<object>` | Yes | Share of guest reviews at each star rating (details only). |
| `rating_distribution.stars` | `integer` | Yes | Star rating, from 1 to 5. |
| `rating_distribution.share` | `number` | Yes | Share of reviews with this rating, from 0 to 1. |
| `review_topics` | `array<object>` | Yes | Topics guests mention in reviews, with how they feel about each (details only). |
| `review_topics.name` | `string` | Yes | Topic, such as `Location` or `Breakfast`. |
| `review_topics.positive_count` | `integer` | Yes | Reviews that speak well of the topic. |
| `review_topics.negative_count` | `integer` | Yes | Reviews that speak badly of the topic. |
| `review_topics.mentions_count` | `integer` | Yes | Reviews that mention the topic. |
| `other_reviews` | `array<object>` | Yes | Ratings of the hotel on other review sites (details only). |
| `other_reviews.source` | `string` | Yes | Name of the review site. |
| `other_reviews.url` | `string` | Yes | URL of the hotel's reviews on that site. |
| `other_reviews.rating` | `number` | Yes | Rating on that site, out of 5. |
| `other_reviews.reviews_count` | `integer` | Yes | Number of reviews on that site. |
| `other_reviews.text` | `string` | Yes | Excerpt of a review from that site. |
| `offers` | `array<object>` | Yes | Prices from each booking site for the stay (details only). |
| `offers.seller` | `string` | Yes | Booking site or the hotel itself. |
| `offers.price` | `object` | Yes | Nightly price on that site. |
| `offers.price.amount` | `number` | Yes | Price as a number. |
| `offers.price.currency` | `string` | Yes | Three-letter currency code of the price. |
| `offers.price.formatted` | `string` | Yes | Price with its currency code, such as `USD 176`. |
| `offers.url` | `string` | Yes | Booking link on Google Hotels for that site. |
| `offers.is_official` | `boolean` | Yes | Whether the offer comes from the hotel's own website. |
| `offers.is_sponsored` | `boolean` | Yes | Whether the offer is a sponsored placement. |
| `offers.free_cancellation_until` | `string` | Yes | Time until which the booking can be cancelled for free, when offered. |
| `images` | `array<string>` | Yes | URLs of photos of the hotel. |
| `rank` | `integer` | Yes | Position of the hotel in the search results, starting at 1 (search only). |
| `query` | `string` | Yes | Search the results are for (search only). |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-google-hotels-hotel-details",
    "status": "succeeded",
    "public_id": "google-hotels/hotel-details",
    "result_count": 1,
    "credits_amount": 2,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "hotel",
      "schema_version": "1.0",
      "items": [
        {
          "id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
          "platform": "google-hotels",
          "resource": "hotel-details",
          "type": "hotel",
          "url": "https://www.google.com/travel/hotels/entity/ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
          "published_at": null,
          "collected_at": "2026-11-17T23:54:22.651788Z",
          "name": "The Rockaway Hotel",
          "text": null,
          "stars": 4,
          "rating": 4.6,
          "reviews_count": 1791,
          "price": {
            "amount": 206,
            "currency": "USD",
            "formatted": "USD 206"
          },
          "check_in": "2026-11-18",
          "check_out": "2026-11-19",
          "is_sponsored": null,
          "address": "108-10 Rockaway Beach Dr, Rockaway Park, NY 11694",
          "phone": "+17184741216",
          "website": "https://www.therockawayhotel.com/",
          "location": {
            "name": "Queens",
            "city": null,
            "region": null,
            "country": null,
            "latitude": 40.5815002,
            "longitude": -73.8300876
          },
          "location_scores": {
            "overall": 3.2,
            "things_to_do": 2.9,
            "restaurants": 3.1,
            "transit": 4.8,
            "airport_access": 4.1
          },
          "check_in_time": "15:00",
          "check_out_time": null,
          "amenities": [
            "Wi-Fi",
            "Wi-Fi in public areas",
            "Public internet workstation"
          ],
          "rating_distribution": [
            {
              "stars": 5,
              "share": 0.8
            },
            {
              "stars": 4,
              "share": 0.1
            },
            {
              "stars": 3,
              "share": 0.04
            }
          ],
          "review_topics": [
            {
              "name": "Wellness",
              "positive_count": 135,
              "negative_count": 17,
              "mentions_count": 166
            },
            {
              "name": "Spa",
              "positive_count": 118,
              "negative_count": 14,
              "mentions_count": 146
            },
            {
              "name": "Pool",
              "positive_count": 110,
              "negative_count": 9,
              "mentions_count": 130
            }
          ],
          "other_reviews": [
            {
              "source": "Tripadvisor",
              "url": "https://www.tripadvisor.com/ShowUserReviews-g48508-d20404929-r1075778183?m=68573&staydates=2026_11_29_2026_11_30&uguests=1_2_0&supdv=desktop&supuc=US&supul=en",
              "rating": 4.300000190734863,
              "reviews_count": 229,
              "text": "Ritz Carlton level of service, if not higher, in every place around the hotel.  We experienced 95% of what they have to offer and it was all A+"
            },
            {
              "source": "Trip.com",
              "url": "https://www.trip.com/hotels/detail?hotelid=58601219&Allianceid=810504&Sid=1394411&utm_medium=cpc&utm_campaign=HPA&utm_source=google#review",
              "rating": 4.300000190734863,
              "reviews_count": 104,
              "text": "Probably better to book directly with Hotel. State of emergency and no one could help with adjusting our day. It is a nice place, the service is great. However during checkout I noticed added charges, that I am waiting getting fixed."
            }
          ],
          "offers": [
            {
              "seller": "Hotels.com",
              "price": {
                "amount": 206,
                "currency": "USD",
                "formatted": "USD 206"
              },
              "url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQARoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYASABEgJifPD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_2mDalbcTS5poMt_i4t-CfoMuV9DQ&adurl",
              "is_official": false,
              "is_sponsored": true,
              "free_cancellation_until": null
            },
            {
              "seller": "Priceline",
              "price": {
                "amount": 240,
                "currency": "USD",
                "formatted": "USD 240"
              },
              "url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQDRoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYAiABEgKBWfD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_3ChNPm9Bp1ahmfS6DbEfne0GmUWQ&adurl",
              "is_official": false,
              "is_sponsored": true,
              "free_cancellation_until": null
            },
            {
              "seller": "Expedia.com",
              "price": {
                "amount": 206,
                "currency": "USD",
                "formatted": "USD 206"
              },
              "url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQERoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYAyABEgI9cvD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_0DwzYWyJs-1IEsz6XQB34gWzq9MA&adurl",
              "is_official": false,
              "is_sponsored": true,
              "free_cancellation_until": null
            }
          ],
          "images": [
            "https://lh3.googleusercontent.com/grass-cs/AABkmLfo__PIr6n9Zm8EP9Vl8usPu2VfsitYLenrvlQRE3y0W-kJNPC7LAVu6rqk2E6a1DqNEvUB9VVo0QvDeyoKDsJZf6FUtzDj-sKTGR2KmT9OYV6KQ1tm-PictQy9dHYUKEyqW5ZK=s287-w287-h192-n-k-no-v1",
            "https://lh3.googleusercontent.com/grass-cs/AABkmLcPSuGEN38ayG11FEdE-3bkuUoo8cdJFyPlOb84MjOd53IDUnYC81kcSVr62wQEDVapW1rTfpghJ5ynGrnBzS6KcpbaCIarNm61FplOJmWxguIRpLseHioQqkVIRpRnsG4DV7Qx8g=s287-w287-h192-n-k-no-v1",
            "https://lh3.googleusercontent.com/grass-cs/AABkmLfOoJ-il_uwZFzkQQdsFJkC5mvJA--sBQ3PW3A6wIaQ5DoS2a-1C225Lmxv3QEx8_UWaCsB-nXWfZ-ztn36i-_X0f-_8Shqz9R4T03KQmRQV6bT7mvSJIEhDypyJwmVOKAW7x7-UA=s287-w287-h192-n-k-no-v1"
          ],
          "rank": null,
          "query": null
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/google-hotels/hotel-details
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/google-hotels/hotel-details:
    post:
      tags:
        - google-hotels
      summary: Google Hotel Details API
      description: >-
        Collect the details, amenities, ratings and booking offers of a hotel on
        Google Hotels.
      operationId: socq_google_hotels_hotel_details
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                check_in:
                  type: string
                  pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
                  description: >-
                    Check-in date in YYYY-MM-DD format. Defaults to tomorrow;
                    give check_out with it.
                check_out:
                  type: string
                  pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
                  description: >-
                    Check-out date in YYYY-MM-DD format, after check_in and at
                    most 30 nights later.
                currency:
                  type: string
                  pattern: ^[A-Za-z]{3}$
                  description: Three-letter currency code for prices, such as USD or EUR.
                hotel_id:
                  type: string
                  minLength: 1
                  description: >-
                    Hotel ID from the `id` field of Google Hotels Search
                    results.
                language_code:
                  type: string
                  minLength: 2
                  maxLength: 10
                  default: en
                  description: Language code of the results. Defaults to en.
                location_code:
                  type: integer
                  minimum: 1
                  description: >-
                    Search market location code. Defaults to 2840 (United
                    States).
                  default: 2840
              required:
                - hotel_id
              description: >-
                Provide a hotel_id from Google Hotels Search. The result is one
                row with the hotel's address, contact details, amenities,
                location scores, guest ratings, review topics and the offers
                from each booking site for the chosen stay.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.