> ## Documentation Index
> Fetch the complete documentation index at: https://brightdata-ipv6-release.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SERP API Google Query Parameters

> Configure Google search, maps, trends, reviews, lens, hotels, and flights with Bright Data's SERP API, including parameters for localization, pagination, device type, parsing, and more.

## Search

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh gl theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

    ```sh hl theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?hl=en"
    ```
  </Accordion>

  <Accordion title="Search type" icon="magnifying-glass">
    ### `tbm`

    Define search type. For regular search there is no need to use the `tbm` parameter while other types have a unique `tbm` value.

    > #### Example:
    >
    > `tbm=isch` - images \
    > `tbm=shop` - shopping \
    > `tbm=nws` - news \
    > `tbm=vid` - videos

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&tbm=shop"
    ```

    ### `ibp`

    Use the `ibp` parameter for Jobs search type.

    > #### Example:
    >
    > `ibp=htl;jobs` - Jobs

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&ibp=htl%3Bjobs"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `start`

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results \
    > `start=20` - second page of results \
    > `start=40` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?start=20"
    ```

    ***

    ### `num`

    Defines the number of results to return.

    > #### Examples:
    >
    > `num=20` (default) - return 20 results \
    > `num=50` - return 50 results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?num=40"
    ```
  </Accordion>

  <Accordion title="Geo-Location" icon="location-dot">
    ### `uule`

    Stands for the encoded location you want to use for your search and will be used to change geo-location. A CSV with all available `uule` values can be [downloaded here](https://developers.google.com/adwords/api/docs/appendix/geotargeting).

    The value of column "Canonical Name" from the CSV can be used as a raw string to the API

    > #### Example:
    >
    > `&uule=New+York,New+York,United+States`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&uule=w+CAIQICINVW5pdGVkK1N0YXRlcw"
    ```
  </Accordion>

  <Accordion title="Device" icon="mobile-screen-button">
    ### `brd_mobile`

    Define what device type to be represented in user-agent. \
    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** \
    > `brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) \
    > `brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) \
    > `brd_mobile=android` - Android phone \
    > `brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&brd_mobile=1"
    ```
  </Accordion>

  <Accordion title="Browser" icon="table-columns">
    ### `brd_browser`

    Define what browser to be represented in user-agent. \
    Can be combined with `brd_mobile` to get according mobile browser. \
    Default will provide random browser.

    > **For specific browser provide one of the following values:** \
    > `brd_browser=chrome` - Google Chrome \
    > `brd_browser=safari` - Safari \
    > `brd_browser=firefox` - Mozilla Firefox (not compatible with `brd_mobile=1`)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&brd_browser=chrome"
    ```
  </Accordion>

  <Accordion title="Parsing" icon="brackets-curly">
    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON \
    > `brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_json=1"
    ```
  </Accordion>

  <Accordion title="Hotel search" icon="buildings">
    ### `hotel_occupancy`

    Number of guests to book a room for (up to 4).
    <Note>See `brd_occupancy` parameter of Hotels which provides more flexibility.</Note>

    > #### Examples:
    >
    > `hotel_occupancy=1` - for 1 guest \
    > `hotel_occupancy=2` (default) - for 2 guests

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&hotel_occupancy=4"
    ```

    ***

    ### `hotel_dates`

    Check-in date and check-out date, separated by comma. \
    Format: `YYYY-MM-DD,YYYY-MM-DD`

    > #### Examples:
    >
    > `hotel_dates=2022-05-01,2022-05-03` - find rooms available from 1st until 3rd of May, 2022

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=pizza&hotel_dates=2023-05-01%2C2023-05-03"
    ```
  </Accordion>

  <Accordion title="Search by image (/searchbyimage only)" icon="image">
    ### `download`

    Download image on the proxy side and post it to google using POST request

    > #### Examples:
    >
    > `default` - download-and-post if google isn't able to download the image \
    > `download=1` - force download-and-post image \
    > `download=0` - regular GET request with image URL

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/searchbyimage?image_url=https%3A%2F%2Flive.staticflickr.com%2F213%2F491726079_4f46636859_w.jpg&download=1"
    ```
  </Accordion>

  <Accordion title="Multiple requests" icon="rectangle-history">
    <Warning>Please note that parallel requests work only with async mode.</Warning>

    ### `multi`

    Make parallel requests through our API server using POST request. \
    Parallel requests will be using the same peer and session and can be used for comparison tests, I.e. making an identical pair of requests with 2 different values for a selected parameter

    > `multi=[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]` - the same keyword with different num param \
    > `multi=[{"query":{"q":"pizza"}},{"query":{"q":"burger"}}]` - different keywords

    To initiate a request, perform:

    ```sh theme={null}
    RESPONSE_ID=$(curl -i --silent --compressed "https://api.brightdata.com/serp/req?customer=<customer-id>&zone=<zone-name>" -H "Content-Type: application/json" -H "Authorization: Bearer API_TOKEN" -d $'{"country":"us","multi":[{"query":{"q":"pizza","num":20}},{"query":{"q":"pizza","num":100}}]}' | sed -En 's/^x-response-id: (.*)/\1/p' | tr -d '\r')
    ```

    `x-response-id` header will contain the id of the request so you can use it in the next request to fetch the result

    ```sh theme={null}
    curl -v --compressed "https://api.brightdata.com/serp/get_result?customer=<customer-id>&zone=<zone-name>&response_id=${RESPONSE_ID}" -H "Authorization: Bearer API_TOKEN"
    ```
  </Accordion>

  <Accordion title="AI Overview" icon="brain">
    ### `brd_ai_mode=1`

    Using `brd_ai_mode=1` will **increase** the likelihood of encountering Google's Generative AI Overviews in your SERP responses (will generally display in \~15-20%+ of results).

    <Note>
      * To better trigger an AI Overview, your SERP keywords must be relevant to topics that Google considers suitable for generative responses.
      * This query parameter is currently supported only on the following Google domains: **google.com**, **google.co.uk**, **google.co.in**, **google.com.au**, **google.ca**.
    </Note>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/search?q=does+honey+ever+expire&brd_ai_mode=1"
    ```
  </Accordion>
</AccordionGroup>

## Maps

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh gl theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?gl=us"
    ```

    ***

    ### `hl`

    Two-letter language code used to define the page languages

    ```sh hl theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?hl=en"
    ```
  </Accordion>

  <Accordion title="Coordinates" icon="location-dot">
    ### `geo params`

    Parameters defining GPS coordinates of a search location. It should be constucted the following way: `@ + latitude + , + longitude + , + zoom`.

    > #### Example:
    >
    > `@47.30227,1.67458,14.00z`

    <Tip>
      The `zoom` parameter is optional but recommended for higher precision. It ranges from 3z, map completely zoomed out - to 21z, map completely zoomed in
    </Tip>

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/service%20de%20transport/@47.30227,1.67458,14.00z"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `start`

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results \
    > `start=20` - second page of results \
    > `start=40` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?start=20"
    ```

    ***

    ### `num`

    Defines the number of results to return.

    > #### Examples:
    >
    > `num=20` (default) - return 20 results \
    > `num=50` - return 50 results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?num=40"
    ```
  </Accordion>

  <Accordion title="Maps place overview" icon="buildings">
    ### `fid`

    Get the results of a Google Maps Place by `fid`.

    Use GET request on [http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s](http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s) with the `fid` value at the end.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "http://www.google.com/maps/place/data=!3m1!4b1!4m2!3m1!1s0x89e37742d0f37093:0xbc048b8a744ff75a"
    ```
  </Accordion>

  <Accordion title="Sorting and filtering" icon="filter">
    ### `brd_accomodation_type`

    Accomodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accomodation_type`=hotels (default) - search for Hotels \
    > `brd_accomodation_type`=vacation\_rentals - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_accomodation_type=vacation_rentals"
    ```
  </Accordion>

  <Accordion title="Output format" icon="magnifying-glass">
    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/maps/search/hotels+new+york/?brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

## Trends

**Required Parameters**\
`brd_json=1`: Returns parsed JSON results (Trends supports parsed results only).\
`brd_trends=timeseries,geo_map`: Retrieves widget data with best success rates.

<Warning>
  We support only the “Trending now” tab within Google Trends. Other tabs (e.g. "Explore", "Home") are not supported as they require login access for full functionality.
</Warning>

<AccordionGroup>
  <Accordion title="Widgets" icon="layer-group">
    To display specific widget data within your Google Trends results, use one of the following widget parameters:

    #### `timeseries`

    #### `geo_map`

    **For multiple widgets:** Separate them with a comma. e.g. `timeseries,geo_map`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Geo" icon="map-location-dot">
    ### `geo`

    Location of interest, two-letter country code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&geo=us&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&hl=de&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Time range" icon="calendar">
    ### `date`

    Time range to search.

    > **Available values are:**&#x20;
    > `now 1-H` - Past hour&#x20;
    > `now 4-H` - Past 4 hours&#x20;
    > `now 1-d` - Past day&#x20;
    > `now 7-d` - Past 7 days&#x20;
    > `today 1-m` - Past 30 days&#x20;
    > `today 3-m` - Past 90 days&#x20;
    > `today 12-m` (default) - Past 12 months&#x20;
    > `today 5-y` - Past 5 years&#x20;
    > `2020-07-01 2020-12-31` - custom date range

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&date=now+1-d&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Category" icon="list">
    ### `cat`

    Category to search within. By default, search within all categories.&#x20;
    You can find list of all categories [here](https://trends.google.com/trends/api/explore/pickers/category?lang=en-US\&tz=240).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&cat=3&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Search type" icon="magnifying-glass">
    ### `gprop`

    Google property to filter on. Defaults to web search.&#x20;
    Possible values are: `images`, `news`, `froogle` (for Google Shopping), `youtube`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> -k "https://trends.google.com/trends/explore?q=pizza&gprop=images&brd_trends=timeseries,geo_map&brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

## Reviews

<AccordionGroup>
  <Accordion title="Feature id" icon="stars">
    ### `fid`

    Feature id what you want to fetch reviews to.
    `fid` parameter can be found in `knowledge.fid` field of google search response.

    > #### For example:
    >
    > [https://www.google.com/search?q=hilton%20new%20york%20midtown](https://www.google.com/search?q=hilton%20new%20york%20midtown)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&hl=de"
    ```
  </Accordion>

  <Accordion title="Sorting and filtering" icon="filter">
    ### `sort`

    The way reviews are sorted.

    > **Possible values are:** \
    > `sort=qualityScore` (default) - most relevant first \
    > `sort=newestFirst` - newest first \
    > `sort=ratingHigh` - highest rating first \
    > `sort=ratingLow` - lowest rating first

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&sort=newestFirst"
    ```

    ### `filter`

    Filter keyword. Will respond with reviews that contain specified keyword only.

    > #### For Example:
    >
    > `filter=awesome` - search for reviews containing 'awesome' word

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&filter=awesome"
    ```
  </Accordion>

  <Accordion title="Pagination" icon="file">
    ### `start`

    Define the result offset - results to start from the selected value. Used for managing pagination.

    > #### Examples:
    >
    > `start=0` (default) - first page of results \
    > `start=10` - second page of results \
    > `start=20` - third page of results, etc.

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&start=10"
    ```

    ### `num`

    Defines the number of results to return.

    > #### Examples:
    >
    > `num=10` (default) - return 10 results \
    > `num=20` - return 20 results (max).

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/reviews?fid=0x808fba02425dad8f%3A0x6c296c66619367e0&num=10"
    ```
  </Accordion>
</AccordionGroup>

## Lens

<AccordionGroup>
  <Accordion title="Image URL" icon="image">
    ### `url`

    URL of image you want to search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png"
    ```
  </Accordion>

  <Accordion title="Localization" icon="flag">
    ### `hl`

    Preferred language, two-letter language code

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&hl=de"
    ```
  </Accordion>

  <Accordion title="Parsing" icon="brackets-curly">
    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON \
    > `brd_json=html` - return JSON with "html" field containing raw HTML

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A%2F%2Fwww.youtube.com%2Fimg%2Fdesktop%2Fyt_1200.png&brd_json=1"
    ```
  </Accordion>

  <Accordion title="Upload image as file" icon="arrow-up-from-bracket">
    ### `upload`

    Upload an image named `cat.jpg` located in a current directory (not supported on async zones)

    ```sh theme={null}
    curl -F "encoded_image=@cat.jpg" --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/v3/upload"
    ```
  </Accordion>

  <Accordion title="Get exact matches" icon="expand">
    ### `brd_lens`

    The `brd_lens` parameter in your request fetches specific Google Lens **tab results** by specifying a tab value (e.g. `products`, `homework`, `visual_matches`, `exact_matches`).

    <img src="https://mintcdn.com/brightdata-ipv6-release/yAA1dELwzqgxV65_/images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png?fit=max&auto=format&n=yAA1dELwzqgxV65_&q=85&s=f9bacec5c9921a051fafe20dca97b3aa" alt="brd_lens" width="1399" height="605" data-path="images/scraping-automation/serp-api/query_parameters/Google_Lens_Tab_paramater_brd_lens.png" />

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://lens.google.com/uploadbyurl?url=https%3A//cdn.shopify.com/s/files/1/0243/303[…]6-05d7-4eb6-bf06-8e0c143f4f00.png%3Fv%3D1693159120&brd_json=1&brd_lens=visual_matches"
    ```
  </Accordion>
</AccordionGroup>

## Hotels

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&gl=us"
    ```

    ### `hl`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&hl=en"
    ```
  </Accordion>

  <Accordion title="Booking dates and options" icon="calendar">
    ### `brd_dates`

    Check-in date and check-out date, separated by comma.

    > #### Format:
    >
    > `YYYY-MM-DD,YYYY-MM-DD`
    >
    > #### Example:
    >
    > `2022-01-20,2022-02-05`

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_dates=2022-04-03%2C2022-04-10"
    ```

    ### `brd_occupancy`

    Number of guests to book a room for (maximum 6 guests).

    > #### Examples:
    >
    > `brd_occupancy=1` - look for a room for 1 person \
    > `brd_occupancy=2` (default) - for 2 persons \
    > `brd_occupancy=3` - for 3 persons, etc.

    Also supports a comma-separated list of integers where:

    * first value is a number of adult guests

    * subsequent values are ages of children

    > #### Format:
    >
    > `brd_occupancy=<number of adults>,<child 1 age>,<child 2 age>,...,<child N age>`
    >
    > #### Examples:
    >
    > `brd_occupancy=1,5,7,12` - for 1 adult and 3 children (5, 7 and 12 years old) \
    > `brd_occupancy=2,1,3` - for 2 adults and 2 children (1 and 3 years old)

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_occupancy=4"
    ```

    ### `brd_free_cancellation`

    Show only offers with free cancellation.

    > #### Examples:
    >
    > `brd_free_cancellation=true` - with free cancellation \
    > `brd_free_cancellation=false` (default) - show any offers

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_free_cancellation=true"
    ```

    ### `brd_accomodation_type`

    Accomodation type: Hotels or Vacation Rentals.

    > #### Examples:
    >
    > `brd_accomodation_type=hotels` (default) - search for Hotels \
    > `brd_accomodation_type=vacation_rentals` - search for Vacation Rentals

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_accomodation_type=vacation_rentals"
    ```

    ### `brd_currency`

    Currency to show prices at (3-letter code).

    > #### Examples:
    >
    > `brd_currency=USD` - United States Dollars \
    > `brd_currency=EUR` - Euro \
    > `brd_currency=INR` - Indian Rupees

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_currency=USD"
    ```
  </Accordion>

  <Accordion title="Output format" icon="magnifying-glass">
    ### `brd_mobile`

    Define what device type to be represented in user-agent

    Default or `brd_mobile=0` will provide random desktop user-agent while `brd_mobile=1` will provide random mobile user-agent.

    > **For specific mobile platform provide one of the following values:** \
    > `brd_mobile=ios` - iPhone user-agent (alias `brd_mobile=iphone`) \
    > `brd_mobile=ipad` - iPad user-agent (alias `brd_mobile=ios_tablet`) \
    > `brd_mobile=android` - Android phone \
    > `brd_mobile=android_tablet` - Android tablet

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_mobile=1"
    ```

    ### `brd_json`

    Bright Data custom parameter allowing to return parsed JSON instead of raw HTML

    > #### Examples:
    >
    > `brd_json=1` - return results in JSON

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/hotels/four%20seasons%20hotel%20new%20york%20downtown/entity/CgoIovWq7d7c9psTEAE/prices?g2lb=2502548,2503771,2503781,4258168,4270442,4284970,4291517,4306835,4401769,4429192,4518326,4597339,4640247,4647135,4649665,4680677,4718357,4721475,4722435,4722900,4723331,4726607,4733969,4734960,4736008,4738608,4741664,4743499&ssta=1&q=four+seasons+hotel+new+york+downtown&grf=EmQKLAgOEigSJnIkKiIKBwjmDxADGB4SBwjmDxAEGAcYAjAeQMoCSgcI5g8QAxgcCjQIDBIwEi6yASsSKQonCiUweDg5YzI1YTE4ZTM1NTNmOGI6MHgxMzM3ZGFlNWVkYWFiYWEy&rp=EKL1qu3e3PabExCi9art3tz2mxM4AkAASAHAAQI&ictx=1&brd_json=1"
    ```
  </Accordion>
</AccordionGroup>

## Flights

<AccordionGroup>
  <Accordion title="Localization" icon="flag">
    ### `gl`

    Two-letter country code used to define the country of search

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&gl=us"
    ```

    ### `hl`

    Two-letter language code used to define the page language

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&hl=en"
    ```
  </Accordion>

  <Accordion title="Flight details" icon="plane-departure">
    ### `tfs`

    String representing flight search parameters

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC"
    ```

    ### `curr`

    Defines the currency of returned prices

    ```sh theme={null}
    curl --proxy brd.superproxy.io:33335 --proxy-user brd-customer-<customer-id>-zone-<zone-name>:<zone-password> "https://www.google.com/travel/flights/search?tfs=CBwQAhoiEgoyMDI0LTA1LTI5agsIAhIHL20vMGszcHIHCAESA1hSSkABSAFwAYIBCwj___________8BmAEC&curr=USD"
    ```
  </Accordion>
</AccordionGroup>