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

> ## Agent Instructions
> Perceptlayer is a web data API: one key for structured JSON from about 250 websites. Base URL https://api.perceptlayer.com.
> Send the key in the X-API-Key header. GET parameters go in the query string; POST parameters in a JSON body.
> A successful call costs the credits on its endpoint (X-Credits-Used); failed calls cost nothing. Errors are {"error": {"code", "message", "request_id"}}.
> AI agents can use every endpoint through the MCP server at https://api.perceptlayer.com/mcp (tools search_endpoints, get_endpoint, call_endpoint), with Authorization: Bearer <key>.
> Get a free key at https://perceptlayer.com/signup.

# Google Hotels: Search

> Search from Google Hotels. Costs 1 credit per successful call.

1 credit per successful call; failed calls are free. See the [Google Hotels API overview](https://perceptlayer.com/apis/google-hotels) for every Google Hotels endpoint.


## OpenAPI

````yaml /openapi.json get /v1/google-hotels/search
openapi: 3.1.0
info:
  title: Perceptlayer API
  version: 1.0.0
  description: >-
    One API key for structured web data. Each successful call costs the credits
    shown on its endpoint; failed calls are free.
servers:
  - url: https://api.perceptlayer.com
security:
  - ApiKeyAuth: []
tags:
  - name: 99acres
  - name: Agoda
  - name: Airbnb
  - name: AliExpress
  - name: Apartments.com
  - name: Apple App Store
  - name: Aramisauto
  - name: Arbeitsagentur Jobs
  - name: Argenprop
  - name: Autohero
  - name: AutoScout24
  - name: AutoTempest
  - name: AutoTrack.nl
  - name: Autotrader
  - name: AutoTrader.ca
  - name: AutoTrader UK
  - name: AutoUncle
  - name: Autovit
  - name: Baidu
  - name: Bandcamp
  - name: Bayut
  - name: Behance
  - name: Bien'ici
  - name: Bilbasen
  - name: Bilibili
  - name: Billiger.de
  - name: Bing
  - name: Blocket Bil
  - name: Bluesky
  - name: Boliga
  - name: Booking.com
  - name: Booli
  - name: Brave Search
  - name: Bring a Trailer
  - name: Capterra
  - name: CarDekho
  - name: CarGurus
  - name: CarMax
  - name: Cars & Bids
  - name: Cars.com
  - name: Cars24
  - name: Carsales
  - name: Carvana
  - name: Carwow
  - name: Casa.it
  - name: Centris
  - name: Coches.net
  - name: Copart
  - name: Craigslist
  - name: Crexi
  - name: Daft.ie
  - name: Dailymotion
  - name: DBA
  - name: Depop
  - name: DeviantArt
  - name: Dice
  - name: Domain Availability
  - name: Domain.com.au
  - name: Dribbble
  - name: Dubizzle
  - name: DuckDuckGo
  - name: eBay
  - name: Economy Car Rentals
  - name: Edmunds
  - name: Eventbrite
  - name: Expedia
  - name: Facebook
  - name: Facebook Ad Library
  - name: Fincaraiz
  - name: FINN
  - name: FINN Bil
  - name: Flickr
  - name: FlixBus
  - name: Fotocasa
  - name: Geizhals
  - name: Genius
  - name: GetYourGuide
  - name: GitHub
  - name: Glassdoor
  - name: Goodreads
  - name: Google Ads Transparency
  - name: Google Events
  - name: Google Finance
  - name: Google Flights
  - name: Google Forums
  - name: Google Hotels
  - name: Google Images
  - name: Google Jobs
  - name: Google Lens
  - name: Google Local
  - name: Google Local Services
  - name: Google Maps
  - name: Google News
  - name: Google Patents
  - name: Google Play
  - name: Google Related Questions
  - name: Google Scholar
  - name: Google Search
  - name: Google Shopping
  - name: Google Short Videos
  - name: Google Translate
  - name: Google Travel Explore
  - name: Google Trends
  - name: Google Videos
  - name: Gumtree
  - name: Habitaclia
  - name: Hacker News
  - name: Hemnet
  - name: heycar
  - name: HolidayCheck
  - name: Holidu
  - name: Homegate
  - name: HomeToGo
  - name: Hostelworld
  - name: HotPads
  - name: IAAI
  - name: Idealista
  - name: Idealo
  - name: Imgur
  - name: ImmobilienScout24
  - name: ImmobilienScout24 Austria
  - name: ImmoScout24 Switzerland
  - name: Immoweb
  - name: Immowelt
  - name: Imovirtual
  - name: Impressum Extraction
  - name: Indeed
  - name: InfoJobs
  - name: Inmuebles24
  - name: Instagram
  - name: Jameda
  - name: Kavak
  - name: Kayak Flights
  - name: Kayak
  - name: Kelley Blue Book
  - name: Kick
  - name: Kijiji
  - name: Kiwi.com
  - name: Kleinanzeigen
  - name: kununu
  - name: Kwai
  - name: La Centrale
  - name: Leboncoin Autos
  - name: Leboncoin Immo
  - name: Lemmy
  - name: Letterboxd
  - name: Link in Bio
  - name: LinkedIn
  - name: Linktree
  - name: LLM Answers
  - name: LoopNet
  - name: Madlan
  - name: MagicBricks
  - name: Marktplaats
  - name: Marktplaats Autos
  - name: Mastodon
  - name: Medium
  - name: Mercado Libre
  - name: Metrocuadrado
  - name: Milanuncios
  - name: Mixcloud
  - name: mobile.de
  - name: Motors.co.uk
  - name: MyAnimeList
  - name: Naukri
  - name: Naver
  - name: North Data
  - name: Odysee
  - name: OfferUp
  - name: Ohne-Makler
  - name: OLX Poland
  - name: Omio
  - name: OnTheMarket
  - name: Otodom
  - name: Otomoto
  - name: Patreon
  - name: Pinterest
  - name: Private Property
  - name: Product Hunt
  - name: Property Finder
  - name: realestate.com.au
  - name: Realtor.ca
  - name: Redfin
  - name: Reed
  - name: Rentalcars.com
  - name: Rentalia
  - name: Ricardo
  - name: Rightmove
  - name: Rumble
  - name: SEEK
  - name: SeLoger
  - name: Semrush
  - name: Similarweb
  - name: Skyscanner
  - name: Snapchat
  - name: SoundCloud
  - name: SpareRoom
  - name: Spotahome
  - name: Spotify
  - name: Sreality
  - name: Standvirtual
  - name: Startpage
  - name: Steam
  - name: StepStone
  - name: Subito
  - name: Subito Motori
  - name: Substack
  - name: SuperCasa
  - name: Telegram
  - name: Threads
  - name: TikTok
  - name: Trade Me Property
  - name: Trainline
  - name: Tripadvisor
  - name: Trivago
  - name: TrueCar
  - name: Trulia
  - name: Trusted Shops
  - name: Trustpilot
  - name: Truth Social
  - name: Tumblr
  - name: tutti.ch
  - name: Twitch
  - name: Viator
  - name: Vimeo
  - name: Vinted
  - name: VivaReal
  - name: VK
  - name: Vrbo
  - name: Wallapop
  - name: Walmart
  - name: Web Scraper
  - name: Weibo
  - name: Welcome to the Jungle
  - name: WG-Gesucht
  - name: willhaben
  - name: wlw
  - name: X (Twitter)
  - name: XING Jobs
  - name: Yad2
  - name: Yaencontre
  - name: Yahoo Search
  - name: Yelp
  - name: YouTube
  - name: Zillow
  - name: Zonaprop
  - name: Zoopla
  - name: Zumper
paths:
  /v1/google-hotels/search:
    get:
      tags:
        - Google Hotels
      summary: Search
      description: Search from Google Hotels. Costs 1 credit per successful call.
      operationId: google_hotels_search
      parameters:
        - name: engine
          in: query
          required: false
          schema:
            type: string
            enum:
              - google_hotels
        - name: q
          in: query
          required: true
          schema:
            type: string
            maxLength: 200
          example: Paris, France
        - name: check_in_date
          in: query
          required: true
          schema:
            type: string
          example: '2026-09-15'
        - name: check_out_date
          in: query
          required: true
          schema:
            type: string
          example: '2026-09-18'
        - name: adults
          in: query
          required: false
          schema:
            type: integer
        - name: children
          in: query
          required: false
          schema:
            type: integer
        - name: currency
          in: query
          required: false
          schema:
            type: string
            maxLength: 3
          example: EUR
        - name: gl
          in: query
          required: false
          schema:
            type: string
            maxLength: 2
          example: fr
        - name: hl
          in: query
          required: false
          schema:
            type: string
            maxLength: 2
        - name: sort_by
          in: query
          required: false
          schema:
            type: integer
            enum:
              - '3'
              - '8'
              - '13'
        - name: min_price
          in: query
          required: false
          schema:
            type: integer
        - name: max_price
          in: query
          required: false
          schema:
            type: integer
        - name: hotel_class
          in: query
          required: false
          schema:
            type: integer
            enum:
              - '2'
              - '3'
              - '4'
              - '5'
        - name: free_cancellation
          in: query
          required: false
          schema:
            type: boolean
        - name: children_ages[]
          in: query
          required: false
          schema:
            type: array
            items:
              type: integer
        - name: rating
          in: query
          required: false
          schema:
            type: integer
            enum:
              - '7'
              - '8'
              - '9'
        - name: amenities[]
          in: query
          required: false
          schema:
            type: array
            items:
              type: integer
        - name: vacation_rentals
          in: query
          required: false
          schema:
            type: boolean
        - name: eco_certified
          in: query
          required: false
          schema:
            type: boolean
        - name: special_offers
          in: query
          required: false
          schema:
            type: boolean
        - name: property_types[]
          in: query
          required: false
          schema:
            type: array
            items:
              type: integer
        - name: brands[]
          in: query
          required: false
          schema:
            type: array
            items:
              type: integer
        - name: bedrooms
          in: query
          required: false
          schema:
            type: integer
        - name: bathrooms
          in: query
          required: false
          schema:
            type: integer
        - name: next_page_token
          in: query
          required: false
          schema:
            type: string
        - name: property_token
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Success
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
            X-Credits-Used:
              $ref: '#/components/headers/CreditsUsed'
            X-Credits-Remaining:
              $ref: '#/components/headers/CreditsRemaining'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
          content:
            application/json:
              schema:
                type: object
                properties:
                  endpoint:
                    type: string
                  params:
                    type: object
                    properties:
                      q:
                        type: string
                      check_in_date:
                        type: string
                      check_out_date:
                        type: string
                      currency:
                        type: string
                      gl:
                        type: string
                  response:
                    type: object
                    properties:
                      search_parameters:
                        type: object
                        properties:
                          engine:
                            type: string
                          q:
                            type: string
                          gl:
                            type: string
                          hl:
                            type: string
                          currency:
                            type: string
                          check_in_date:
                            type: string
                          check_out_date:
                            type: string
                          adults:
                            type: integer
                          children:
                            type: integer
                      search_information:
                        type: object
                        properties:
                          total_results:
                            type: integer
                          cached:
                            type: boolean
                      brands:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                            name:
                              type: string
                      properties:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                            name:
                              type: string
                            description:
                              type: string
                            link:
                              type: string
                            property_token:
                              type: string
                            _property_details_link:
                              type: string
                            _google_hotels_reviews_link:
                              type: string
                            gps_coordinates:
                              type: object
                              properties:
                                latitude:
                                  type: number
                                longitude:
                                  type: number
                            check_in_time:
                              type: string
                            check_out_time:
                              type: string
                            rate_per_night:
                              type: object
                              properties:
                                lowest:
                                  type: string
                                extracted_lowest:
                                  type: integer
                                before_taxes_fees:
                                  type: string
                                extracted_before_taxes_fees:
                                  type: number
                            total_rate:
                              type: object
                              properties:
                                lowest:
                                  type: string
                                extracted_lowest:
                                  type: integer
                                before_taxes_fees:
                                  type: string
                                extracted_before_taxes_fees:
                                  type: number
                            nearby_places:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                  transportations:
                                    type: array
                                    items:
                                      type: string
                            images:
                              type: array
                              items:
                                type: object
                                properties:
                                  thumbnail:
                                    type: string
                                  original_image:
                                    type: string
                            overall_rating:
                              type: number
                            reviews:
                              type: integer
                            ratings:
                              type: array
                              items:
                                type: object
                                properties:
                                  stars:
                                    type: integer
                                  count:
                                    type: integer
                            location_rating:
                              type: number
                            reviews_breakdown:
                              type: array
                              items:
                                type: object
                                properties:
                                  name:
                                    type: string
                                  description:
                                    type: string
                                  total_mentioned:
                                    type: integer
                                  positive:
                                    type: integer
                                  negative:
                                    type: integer
                                  neutral:
                                    type: integer
                            amenities:
                              type: array
                              items:
                                type: string
                            eco_certified:
                              type: boolean
                            hotel_class:
                              type: string
                            extracted_hotel_class:
                              type: integer
                      pagination:
                        type: object
                        properties:
                          current_from:
                            type: integer
                          current_to:
                            type: integer
                          next_page_token:
                            type: string
                          next:
                            type: string
                      response_time_ms:
                        type: integer
                description: >-
                  The fields of a recorded response. Other responses can carry
                  more, or leave some out.
              example:
                endpoint: google-hotels.search
                params:
                  q: Paris, France
                  check_in_date: '2026-12-15'
                  check_out_date: '2026-12-18'
                  currency: EUR
                  gl: fr
                response:
                  search_parameters:
                    engine: google_hotels
                    q: Paris, France
                    gl: fr
                    hl: en
                    currency: EUR
                    check_in_date: '2026-12-15'
                    check_out_date: '2026-12-18'
                    adults: 2
                    children: 0
                  search_information:
                    total_results: 15000
                    cached: false
                  brands:
                    - id: 118
                      name: Park Hyatt
                    - id: 155
                      name: Best Western
                    - id: 151
                      name: Curio Collection
                  properties:
                    - type: hotel
                      name: Novotel Paris Porte de Versailles
                      description: >-
                        Bright, hip rooms in a polished hotel featuring 2
                        restaurants, 2 bars & an airy cafe.
                      link: >-
                        https://all.accor.com/lien_externe.svlt?goto=fiche_hotel&code_hotel=A7L6&merchantid=seo-maps-FR-A7L6&sourceid=aw-cen&utm_medium=seo%20maps&utm_source=google%20Maps&utm_campaign=seo%20maps
                      property_token: ChkI5rWisq2xuMNRGg0vZy8xMWhfa18xc2w4EAE
                      _property_details_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChkI5rWisq2xuMNRGg0vZy8xMWhfa18xc2w4EAE
                      _google_hotels_reviews_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChkI5rWisq2xuMNRGg0vZy8xMWhfa18xc2w4EAE
                      gps_coordinates:
                        latitude: 48.8300073
                        longitude: 2.2917392999999997
                      check_in_time: 3:00 PM
                      check_out_time: 12:00 PM
                      rate_per_night:
                        lowest: €136
                        extracted_lowest: 136
                        before_taxes_fees: €136
                        extracted_before_taxes_fees: 135.76042
                      total_rate:
                        lowest: €408
                        extracted_lowest: 408
                        before_taxes_fees: €407
                        extracted_before_taxes_fees: 407.28126000000003
                      nearby_places:
                        - name: Porte de Versailles
                          transportations:
                            - …
                        - name: Aéroport de Paris-Charles de Gaulle
                          transportations:
                            - …
                            - …
                        - name: French Kiss Paris Restaurant Porte de Versailles
                          transportations:
                            - …
                      images:
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLd76it64PbXMOeDM3EYDzuhckiR6Z0TyqIfqJDDc87YmPivQT43V36f6ivqJHdSgnYu0tB7SwZbD_9eMwEhwLrdBQ-Nc1Z05Im5pUHcEqg5Oj8ZsLN5A628wexYUHgNmCnbZ44drg=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLd76it64PbXMOeDM3EYDzuhckiR6Z0TyqIfqJDDc87YmPivQT43V36f6ivqJHdSgnYu0tB7SwZbD_9eMwEhwLrdBQ-Nc1Z05Im5pUHcEqg5Oj8ZsLN5A628wexYUHgNmCnbZ44drg=s10000
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfmAap2Mz63jNdbAtJ24yMLC7RCDjKux7xiSKv5NTci2iJUNfQ5e5W9yO3qmQfSfHllkGGNvPYoSoDiQFHNA3UWEpx1qhj7OngfJ5ozBSSX1ylbPNtn94tu5L_h9excC4bpojLZ-A=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfmAap2Mz63jNdbAtJ24yMLC7RCDjKux7xiSKv5NTci2iJUNfQ5e5W9yO3qmQfSfHllkGGNvPYoSoDiQFHNA3UWEpx1qhj7OngfJ5ozBSSX1ylbPNtn94tu5L_h9excC4bpojLZ-A=s10000
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfq-wB7yinGLeef4n1SjzMUO5zadRUazpnm0UAR8nOLcnd5Bf9Cx8UElnQiOXD3PvvS7lvuHjw-7NYfCY13SwXzIPObFFP0Ias1Ycd-yiQqGYPNExQxv0G6zokRF7i6lT9uwrOlRQ=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfq-wB7yinGLeef4n1SjzMUO5zadRUazpnm0UAR8nOLcnd5Bf9Cx8UElnQiOXD3PvvS7lvuHjw-7NYfCY13SwXzIPObFFP0Ias1Ycd-yiQqGYPNExQxv0G6zokRF7i6lT9uwrOlRQ=s10000
                      overall_rating: 4.6
                      reviews: 4337
                      ratings:
                        - stars: 5
                          count: 3356
                        - stars: 4
                          count: 604
                        - stars: 3
                          count: 154
                      location_rating: 3.5
                      reviews_breakdown:
                        - name: Family
                          description: Family friendly
                          total_mentioned: 53
                          positive: 35
                          negative: 14
                          neutral: 4
                        - name: Parking
                          description: Parking
                          total_mentioned: 13
                          positive: 9
                          negative: 4
                          neutral: 0
                        - name: Dining
                          description: Food and Beverage
                          total_mentioned: 57
                          positive: 36
                          negative: 16
                          neutral: 5
                      amenities:
                        - Breakfast ($)
                        - Free Wi-Fi
                        - Parking ($)
                      eco_certified: false
                      hotel_class: 4-star hotel
                      extracted_hotel_class: 4
                    - type: hotel
                      name: Hôtel Aramis Saint-Germain Best Western
                      link: https://www.hotel-aramis.com/
                      property_token: ChgIyMGH_b-Xg4NzGgwvZy8xaGM0N2t0a3cQAQ
                      _property_details_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChgIyMGH_b-Xg4NzGgwvZy8xaGM0N2t0a3cQAQ
                      _google_hotels_reviews_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChgIyMGH_b-Xg4NzGgwvZy8xaGM0N2t0a3cQAQ
                      gps_coordinates:
                        latitude: 48.8467135
                        longitude: 2.3264518
                      check_in_time: 2:00 PM
                      check_out_time: 12:00 PM
                      rate_per_night:
                        lowest: €124
                        extracted_lowest: 124
                        before_taxes_fees: €124
                        extracted_before_taxes_fees: 123.729164
                      total_rate:
                        lowest: €372
                        extracted_lowest: 372
                        before_taxes_fees: €371
                        extracted_before_taxes_fees: 371.187492
                      nearby_places:
                        - name: Musée d'Orsay
                          transportations:
                            - …
                        - name: Aéroport de Paris-Charles de Gaulle
                          transportations:
                            - …
                            - …
                      images:
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-proxy/AIM7gW2-eCCTHP6_Tg_wB9LMqXZRJ7ePP__UntQVCbvRal3e2hUaxNWaz8NqP_YmxVkzkSGj87OL1vbWNbd_vep1cMgIkEbYXmWST-TlJjgBnFIV5iN_EkaG1iCTV6ymu4-MSbJz2DU5oobzlsEMoYxEx1SB2swblWNigiAxAbcyqQPtD2Rh_xChAUY=s287-w…
                          original_image: >-
                            https://www.iceportal.com/data/2813-48433-f84165562_XXLejpg/France/Paris/BEST-WESTERN-Aramis-Saint-Germain/Photo/BEST-WESTERN-Aramis-Saint-Germain-Paris-Undefined-BREAKFAST-AREA.jpg
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLduTWt9e_4w7c3IDZlsDbFIMDQVdqnKtXwr-GnQ9vbD7qeTl3AR_MkI9G_dLi7q_TCPME4IInw3qH1EBtc4HN35XemtdpILTzryU7RHWvYr9xs4OI3VgWgw9nEaGjeUi3aEvSWinQ=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLduTWt9e_4w7c3IDZlsDbFIMDQVdqnKtXwr-GnQ9vbD7qeTl3AR_MkI9G_dLi7q_TCPME4IInw3qH1EBtc4HN35XemtdpILTzryU7RHWvYr9xs4OI3VgWgw9nEaGjeUi3aEvSWinQ=s10000
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfSf_jHH10KMLz--2hVNagtfhOvbI2RFSwczCNZV2DtulMROK5zNtCzoE_fhUVCISXFBvF-dVNSqDxQ-50G2nFvuwKyubcMAxWoHyaAFMIj_5m3V769O79R7qUZZ6svbs3cQ0nnonwSdNsc=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfSf_jHH10KMLz--2hVNagtfhOvbI2RFSwczCNZV2DtulMROK5zNtCzoE_fhUVCISXFBvF-dVNSqDxQ-50G2nFvuwKyubcMAxWoHyaAFMIj_5m3V769O79R7qUZZ6svbs3cQ0nnonwSdNsc=s10000
                      overall_rating: 4.4
                      reviews: 826
                      ratings:
                        - stars: 5
                          count: 482
                        - stars: 4
                          count: 244
                        - stars: 3
                          count: 61
                      location_rating: 4.6
                      reviews_breakdown:
                        - name: Location
                          description: Location
                          total_mentioned: 162
                          positive: 155
                          negative: 3
                          neutral: 4
                        - name: Service
                          description: Service
                          total_mentioned: 153
                          positive: 140
                          negative: 10
                          neutral: 3
                        - name: Property
                          description: Property
                          total_mentioned: 143
                          positive: 106
                          negative: 20
                          neutral: 17
                      amenities:
                        - Breakfast ($)
                        - Free Wi-Fi
                        - Air conditioning
                      eco_certified: false
                      hotel_class: 3-star hotel
                      extracted_hotel_class: 3
                    - type: hotel
                      name: Hyatt Regency Paris Étoile
                      description: >-
                        Modern rooms & suites in a polished lodging with elegant
                        dining & a bar with panoramic city views.
                      link: >-
                        https://photos.hotelbeds.com/giata/original/18/180655/180655a_hb_a_031.jpg?20250110134229?20250611043504
                      property_token: ChcIpP7F8OHV3Y5FGgsvZy8xdGdzMDdichAB
                      _property_details_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChcIpP7F8OHV3Y5FGgsvZy8xdGdzMDdichAB
                      _google_hotels_reviews_link: >-
                        https:///api/google-hotels/search?q=Paris%2C+France&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&currency=EUR&hl=en&gl=fr&property_token=ChcIpP7F8OHV3Y5FGgsvZy8xdGdzMDdichAB
                      gps_coordinates:
                        latitude: 48.880506399999994
                        longitude: 2.284538
                      check_in_time: 3:00 PM
                      check_out_time: 12:00 PM
                      rate_per_night:
                        lowest: €224
                        extracted_lowest: 224
                        before_taxes_fees: €224
                        extracted_before_taxes_fees: 223.53247
                      total_rate:
                        lowest: €672
                        extracted_lowest: 672
                        before_taxes_fees: €671
                        extracted_before_taxes_fees: 670.59741
                      nearby_places:
                        - name: Fondation Louis Vuitton
                          transportations:
                            - …
                        - name: Neuilly Porte Maillot
                          transportations:
                            - …
                        - name: Aéroport de Paris-Charles de Gaulle
                          transportations:
                            - …
                            - …
                      images:
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLemyB5o_BWjO5ocucowLo5zqKr6q2VFSi2xnefSNhlpGMMXZVGdefAtYPEKOG78iig6NQ1bNOW_DMxL5BX33DucA4G5uZzN6mA59e_9DTPJt4OvwxH9ZL7qW0BbjNwDkjfNdZIh6g0vmVYS=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLemyB5o_BWjO5ocucowLo5zqKr6q2VFSi2xnefSNhlpGMMXZVGdefAtYPEKOG78iig6NQ1bNOW_DMxL5BX33DucA4G5uZzN6mA59e_9DTPJt4OvwxH9ZL7qW0BbjNwDkjfNdZIh6g0vmVYS=s10000
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfkU8SQFqNrtNu8QM7qNdGDi3BkrckOXqlWENQZKyX6tYpY7-SX1wutMG6DYhD2EKL1KsIqKFWLL2UmFR0bFmD8oad0CymgpP1HMgZBCJEmIzo0vDJjCTyd-cUhG3SVyln5Xs8YAA=s287-w287-h192-n-k-no-v1
                          original_image: >-
                            https://lh3.googleusercontent.com/grass-cs/AABkmLfkU8SQFqNrtNu8QM7qNdGDi3BkrckOXqlWENQZKyX6tYpY7-SX1wutMG6DYhD2EKL1KsIqKFWLL2UmFR0bFmD8oad0CymgpP1HMgZBCJEmIzo0vDJjCTyd-cUhG3SVyln5Xs8YAA=s10000
                        - thumbnail: >-
                            https://lh3.googleusercontent.com/grass-proxy/AIM7gW0HEzny4-ByZpd--RKSzILrQ_utV1SpkzLe85xJn14nz7fDLHMSaCQZTu4iN8oetT9u2JbtV396hHkA4jZGnfv4PponKthgW7S_bzrn9d9siQdC8LbuDDI2HLhfaLM4p8tKMJ194vGTNw7cHAH8rBXnYazWhK2Slk-UfmuJaiHagArmd04ib774ig=s28…
                          original_image: >-
                            https://photos.hotelbeds.com/giata/original/18/180655/180655a_hb_a_031.jpg?20250110134229?20250611043504
                      overall_rating: 4.4
                      reviews: 6485
                      ratings:
                        - stars: 5
                          count: 4052
                        - stars: 4
                          count: 1505
                        - stars: 3
                          count: 464
                      location_rating: 4.3
                      reviews_breakdown:
                        - name: Nature
                          description: Nature and outdoor activities
                          total_mentioned: 65
                          positive: 62
                          negative: 0
                          neutral: 3
                        - name: Business
                          description: Business
                          total_mentioned: 86
                          positive: 47
                          negative: 20
                          neutral: 19
                        - name: Bar
                          description: Bar or lounge
                          total_mentioned: 188
                          positive: 136
                          negative: 37
                          neutral: 15
                      amenities:
                        - Breakfast ($)
                        - Free Wi-Fi
                        - Parking ($)
                      eco_certified: false
                      hotel_class: 4-star hotel
                      extracted_hotel_class: 4
                  pagination:
                    current_from: 1
                    current_to: 20
                    next_page_token: gho_jRZtj7WKgqLkF8eP.Q0JJPQ
                    next: >-
                      https:///api/google-hotels/search?q=Paris%2C+France&gl=fr&hl=en&currency=EUR&check_in_date=2026-12-15&check_out_date=2026-12-18&adults=2&children=0&next_page_token=gho_jRZtj7WKgqLkF8eP.Q0JJPQ
                  response_time_ms: 2501
        '401':
          $ref: '#/components/responses/Error'
        '402':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '410':
          $ref: '#/components/responses/Error'
        '422':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/Error'
        '502':
          $ref: '#/components/responses/Error'
        '503':
          $ref: '#/components/responses/Error'
        '504':
          $ref: '#/components/responses/Error'
components:
  headers:
    RequestId:
      description: Unique ID for this request; quote it in support requests.
      schema:
        type: string
    CreditsUsed:
      description: Credits charged for this call (0 when it failed).
      schema:
        type: integer
    CreditsRemaining:
      description: Your balance after this call.
      schema:
        type: integer
    RateLimitLimit:
      description: >-
        Requests a minute your account may make: its rate in requests per second
        times 60.
      schema:
        type: integer
    RateLimitRemaining:
      description: Requests left in the current minute, shared by every key on the account.
      schema:
        type: integer
    RateLimitReset:
      description: Seconds until the current minute's count starts over.
      schema:
        type: integer
    RateLimitPolicy:
      description: The limit and its window in seconds, for example "300;w=60".
      schema:
        type: string
  responses:
    Error:
      description: Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````

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